Get the processing status of a document
curl --request GET \
--url https://app.sahlfinancial.com/api/v1/documents/{document_id}/status \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.sahlfinancial.com/api/v1/documents/{document_id}/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.sahlfinancial.com/api/v1/documents/{document_id}/status"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"document_id": "a8f1c3e5-6b2d-4974-8e0a-1d5c7b9f3e26",
"status": "processing",
"page_count": 3,
"document_type_detected": "payslip",
"created_at": "2026-10-07T09:14:22Z",
"updated_at": "2026-10-07T09:14:22Z",
"job_id": "3c9d7b1f-5e2a-4a86-9f4c-8b0e6d2a1c75",
"stage": "processing",
"pages_total": 3,
"pages_done": 1,
"error_code": null
}{
"detail": "Invalid or expired token"
}{
"detail": "Insufficient permissions"
}{
"detail": "Document not found"
}{
"detail": [
{
"type": "missing",
"loc": [
"body",
"bank_code"
],
"msg": "Field required",
"input": {}
}
]
}{
"code": "rate_limit_exceeded",
"message": "Too many requests. Please slow down."
}Get the processing status of a document
Who can call it: Any signed-in member of the workspace.
Light call for polling. status is one of uploaded, queued, processing, completed, completed_with_warnings, failed, review_required.
Auth: dashboard session (Authorization: Bearer <access token>). Not available with a partner API key.
Get the processing status of a document
curl --request GET \
--url https://app.sahlfinancial.com/api/v1/documents/{document_id}/status \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.sahlfinancial.com/api/v1/documents/{document_id}/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.sahlfinancial.com/api/v1/documents/{document_id}/status"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"document_id": "a8f1c3e5-6b2d-4974-8e0a-1d5c7b9f3e26",
"status": "processing",
"page_count": 3,
"document_type_detected": "payslip",
"created_at": "2026-10-07T09:14:22Z",
"updated_at": "2026-10-07T09:14:22Z",
"job_id": "3c9d7b1f-5e2a-4a86-9f4c-8b0e6d2a1c75",
"stage": "processing",
"pages_total": 3,
"pages_done": 1,
"error_code": null
}{
"detail": "Invalid or expired token"
}{
"detail": "Insufficient permissions"
}{
"detail": "Document not found"
}{
"detail": [
{
"type": "missing",
"loc": [
"body",
"bank_code"
],
"msg": "Field required",
"input": {}
}
]
}{
"code": "rate_limit_exceeded",
"message": "Too many requests. Please slow down."
}Authorizations
The access token (JWT) of a signed-in console user, from POST /v1/auth/login. It lasts 30 minutes. It is not an API key: a partner API key is refused here. There is no cookie.
Path Parameters
Response
OK