Developers

belege.ai Public API

A stable REST API for your own tools: read transactions, search receipts, download files, and upload new documents into the existing extraction pipeline.

Base URL

https://belege.ai/api/v1

Auth

Authorization: Bearer belege_live_...

Scopes

public_api:read / public_api:write

Schema

/api/v1/openapi.json

Current account

curl -H 'Authorization: Bearer belege_live_...' https://belege.ai/api/v1/me

Search transactions

curl -H 'Authorization: Bearer belege_live_...' 'https://belege.ai/api/v1/transactions?q=AWS&limit=25'

List documents

curl -H 'Authorization: Bearer belege_live_...' 'https://belege.ai/api/v1/documents?source=upload,telegram&type=invoice,receipt&limit=50&offset=0'

Upload a document

curl -X POST -H 'Authorization: Bearer belege_live_...' -F file=@invoice.pdf -F transactionId=11111111-1111-1111-1111-111111111111 -F note='Import from internal tool' https://belege.ai/api/v1/documents

Download a file

curl -L -H 'Authorization: Bearer belege_live_...' https://belege.ai/api/v1/documents/document_extraction:11111111-1111-1111-1111-111111111111/file -o beleg.pdf

Pagination

Lists return data plus pagination with limit, offset, total, hasMore. Limit is capped at 200.

Errors

{"error":{"code":"invalid_bearer_token","message":"..."}}

Uploads

PDF, JPG, JPEG, PNG only. Max 16 MB. Requires public_api:write.