​
Base URL

The base URL for all API endpoints is: 
https://api.abbyy.com/document-ai/

​
Authentication

To access the Document AI API, you’ll need an API key. You can manage your API keys in our developer dashboard. Include your API key in the Authorization header using Bearer token authentication: 
Authorization: Bearer <API-Key>

​
Response Codes

The API returns standard HTTP status codes to indicate the success or failure of your request.
CodeDescription
200A successful request.
201Resource creation successful. A Link header will be returned with the URL to the newly created resource.
400There is something wrong with your request. The error will include details about the issues.
401The Authentication header is either missing or invalid.
404The resource or endpoint wasn’t found.
413The content of the request is too large for the API to handle.
429Too many requests in too short a time period.
500We encountered an unexpected error handling the request.
Several API operations will include a Link header in a successful response. These are RFC 8288-compliant web links that can be used to make requests to the API that are related to the content in the body of the response. For example, the response to a successful request to a Begin* operation might include a link that can be used to obtain the results of processing: 
$ curl -v https://api.abbyy.com/document-ai/v1-preview/models/image-to-text -d "..."
# ...
Request completely sent off
< HTTP/2 200
# ...
< link: <https://api.abbyy.com/document-ai/v1-preview/models/image-to-text/ya4kors1xqpaypi1dftibtqq>; rel=results; id=ya4kors1xqpaypi1dftibtqq

​
Pagination

Some API operations return list data in a paginated fashion. These operations will also include web links where the rel parameter is prev or next, indicating that the link corresponds to the previous or next page of data, respectively: 
< link: <https://api.abbyy.com/document-ai/v1-preview/documents?limit=10&cursor=f2v9nx007o48f6z5y0cnef4s>; rel=next, <https://api.abbyy.com/document-ai/v1-preview/models/personal-earnings-statement/tfr5c3uikzth9qyp8d89yt6k>; rel=results; id=tfr5c3uikzth9qyp8d89yt6k, ...
The presence of these links can be used to determine if there is more data in the list that can be retrieved from the API. In the above example, the user can move “forward” in the list using the link where rel=next, but the lack of a link where rel=prev indicates that this response contains the first page of the list. Note that the above example also contains web links to obtain the results corresponding to documents in the list.

​
Error Responses

Error responses follow the RFC 9457 format and include the following properties:
Property NameDescription
typeA URI reference that identifies the error type. This value is stable and can be used for programmatic error handling
titleA short, human-readable summary of the problem
statusThe HTTP status code of the response
detailA human-readable explanation specific to this occurrence of the problem
Requests that result in a 400 Bad Request status code include additional validation and validationContext properties with details about the validation issues.