List documents
curl --request GET \
--url https://app.sahlfinancial.com/api/v1/documents \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.sahlfinancial.com/api/v1/documents', 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"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"id": "a8f1c3e5-6b2d-4974-8e0a-1d5c7b9f3e26",
"tenant_id": "0b6f5a3e-7c1d-4e0a-9d2f-3a1c5e8b7f10",
"external_reference": null,
"filename": "payslip-test.pdf",
"content_type": "application/pdf",
"file_size": 184320,
"upload_source": "api",
"document_type_hint": "payslip",
"document_type_detected": "payslip",
"document_type_final": null,
"status": "completed",
"page_count": 1,
"checksum_sha256": "9f2c...redacted",
"created_at": "2026-10-07T09:14:22Z",
"updated_at": "2026-10-07T09:14:22Z"
}
],
"total": 1,
"page": 1,
"page_size": 20
}{
"detail": "Invalid or expired token"
}{
"detail": "Insufficient permissions"
}{
"detail": [
{
"type": "missing",
"loc": [
"body",
"bank_code"
],
"msg": "Field required",
"input": {}
}
]
}{
"code": "rate_limit_exceeded",
"message": "Too many requests. Please slow down."
}List documents
Who can call it: Any signed-in member of the workspace.
Newest first. Send X-Sahl-Environment: sandbox or production (or the environment query parameter) to choose the workspace. Without it, no environment filter is applied. production is refused with 403 production_requires_paid_plan when the subscription is cancelled or suspended.
Auth: dashboard session (Authorization: Bearer <access token>). Not available with a partner API key.
List documents
curl --request GET \
--url https://app.sahlfinancial.com/api/v1/documents \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.sahlfinancial.com/api/v1/documents', 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"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"id": "a8f1c3e5-6b2d-4974-8e0a-1d5c7b9f3e26",
"tenant_id": "0b6f5a3e-7c1d-4e0a-9d2f-3a1c5e8b7f10",
"external_reference": null,
"filename": "payslip-test.pdf",
"content_type": "application/pdf",
"file_size": 184320,
"upload_source": "api",
"document_type_hint": "payslip",
"document_type_detected": "payslip",
"document_type_final": null,
"status": "completed",
"page_count": 1,
"checksum_sha256": "9f2c...redacted",
"created_at": "2026-10-07T09:14:22Z",
"updated_at": "2026-10-07T09:14:22Z"
}
],
"total": 1,
"page": 1,
"page_size": 20
}{
"detail": "Invalid or expired token"
}{
"detail": "Insufficient permissions"
}{
"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.
Headers
Query Parameters
Required range:
x >= 1Required range:
1 <= x <= 100Available options:
uploaded, queued, processing, completed, completed_with_warnings, failed, review_required Available options:
api, dashboard, webhook, batch, partner Maximum string length:
255