Documentation for Staple's REST APIs | Staple AI

By vvluc@staple.io / josh@staple.io / hello@staple.io

See our demo at https://www.staple.io/demo if you would wish to sample the scanning using a simple drag and drop interface before using the API directly.

What is this API for?

Use the Staple API to upload and process invoices, receipts, and other documents with your queue’s configured model. Submit files with Scan Asynchronous Document or Scan Asynchronous Multiple Documents, then retrieve the results with Get Document by ID after processing completes. This API is optimized for computer generated PDFs, which will have the best performance. However, pdf scans, png, jpeg, tiff, jfif, and docx are also supported.

Please expect the API to change and improve over the coming weeks and months as the models are being constantly improved at Staple. The values and dictionaries key of returned JSON will not be removed, however new ones may be added.

Authentication

Authenticate requests with your x-api-key header plus an Authorization: Bearer <token> header, where the token is the JWT returned by the login endpoint. Contact hello@staple.io for API access.

Rates

The API is load balanced, and should be able to handle a significant number of requests in parallel, but we appreciate your patience with any issues that may occur regarding dropped responses. We recommend testing with no more that 10 parallel requests at a time.

Staple AI reserves the right to make changes to the API, including registration process, access and response values at any time. That means that the returned values you see now are not fixed, and may be subject to change.