Overview

Introduction

Elis Document Management API allows you to programmatically access and manage your organization's Elis data and account information. The API allows you to do the following:

• Configure Elis to suite you needs: select extracted fields
• Integrate Elis with other systems: import, export, extensions
• Manage your organization, users, workspaces and queues

Elis Document Management builds on top of the Data Extraction API to extract information from documents. Sometimes, we refer to Data Extraction API as RIR.

How Do I Start?

This documentation provides Getting Started tutorial that walks you through making your first API calls to upload a document and export extracted data from Elis.

If in trouble, feel free to contact us at support@rossum.ai.

HTTP and REST

The Elis Data Management API is organized around REST. Our API has predictable, resource-oriented URLs, and uses HTTP response codes to indicate API errors. We use built-in HTTP features, like HTTP authentication and HTTP verbs, which are understood by off-the-shelf HTTP clients.

HTTP Verbs

Call the API using the following standard HTTP methods:

• GET to retrieve an object or multiple objects in a specific category
• POST to create an object
• PUT to modify entire object
• PATCH to modify fields of the object
• DELETE to delete an object

We support cross-origin resource sharing, allowing you to interact securely with our API from a client-side web application. JSON is returned by API responses, including errors (except when another format is requested, e.g. XML).

Authentication

Most of the API endpoints require user to be authenticated. To login to Elis DM API, post an object with username and password fields. Login returns new authentication key to be used in token authentication.

User may delete a token using logout endpoint or automatically after a configured time (maximum expire time is 162 hours). When token expires, 401 status is returned. Users are expected to re-login to obtain a new token.

Login

Login user using username and password

curl -H 'Content-Type: application/json' \
  -d '{"username": "east-west-trading-co@elis.rossum.ai", "password": "aCo2ohghBo8Oghai"}' \
  'https://api.elis.rossum.ai/v1/auth/login'

{
  "key": "db313f24f5738c8e04635e036ec8a45cdd6d6b03"
}

POST /v1/auth/login

Use token key in requests

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/organizations/406'

Response

Status: 200

Returns object with "key", which is an actual authentication token.

Logout

Logout user

curl -X POST -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/auth/logout'

{
  "detail": "Successfully logged out."
}

POST /v1/auth/logout

Logout user, discard auth token.

Response

Status: 200

Pagination

All object list operations are paged by default, so you may need several API calls to obtain all objects of given type.

Parameter	Default	Maximum	Description
page_size	20	100 (*)	Number of results per page
page	1		Page of results

(*) Maximum page size of annotation list and CSV export is 1000.

Filters and ordering

List queues of workspace 7540, with locale en_US and order results by name.

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/queues?workspace=7540&locale=en_US&ordering=name'

Lists may be filtered using various attributes. Please refer to the particular object description.

All filter parameters that refers to object expect only id (instead of URL) of the object.

Ordering of results may be enforced by the ordering parameter and one or more keys delimited by a comma. Preceding key with a minus sign - enforces descending order.

Metadata

Example metadata in a document object

{
  "id": 319768,
  "url": "https://api.elis.rossum.ai/v1/documents/319768",
  "s3_name": "05feca6b90d13e389c31c8fdeb7fea26",
  "annotations": [
    "https://api.elis.rossum.ai/v1/annotations/319668"
  ],
  "mime_type": "application/pdf",
  "arrived_at": "2019-02-11T19:22:33.993427Z",
  "original_file_name": "document.pdf",
  "content": "https://api.elis.rossum.ai/v1/documents/319768/content",
  "metadata": {
    "customer-id": "f205ec8a-5597-4dbb-8d66-5a53ea96cdea",
    "source": "local"
  }
}

When working with API objects, it may be useful to attach some information to the object (e.g. customer id to a document). You can store custom string key-value pairs in a metadata section available in most objects.

List of objects with metadata support: organization, workspace, queue, schema, connector, inbox, document, annotation, page.

Total metadata size may be up to 1 kB per object.

Versioning

API Version is part of the URL, e.g. https://api.elis.rossum.ai/v1/users.

To allow API progress, we consider addition of a field in a JSON object to be a backward-compatible operation that may be introduced at any time. Clients are expected to deal with such changes.

In order to be notified about future API changes and improvements, please subscribe to elis-api-announcements group.

Dates

All dates fields are represented as ISO 8601 formatted strings, e.g. 2018-06-01T21:36:42.223415Z. All returned dates are in UTC timezone.

Errors

Our API uses conventional HTTP response codes to indicate the success or failure of an API request.

Code	Status	Meaning
400	Bad Request	Invalid input data or error from connector.
401	Unauthorized	The username/password is invalid or token is invalid (e.g. expired).
403	Forbidden	Insufficient permission, missing authentication, invalid CSRF token and similar issues.
404	Not Found	Entity not found (e.g. already deleted).
405	Method Not Allowed	You tried to access an endpoint with an invalid method.
409	Conflict	Trying to change annotation not currently assigned or assigned to another user.
413	Payload Too Large	for too large payload (especially for files uploaded).
500	Internal Server Error	We had a problem with the server. Try again later.
503	Service Unavailable	We're temporarily offline for maintenance. Please try again later.

Getting Started

Here you will learn how to authenticate, upload a document and export extracted data. You need curl or similar tool to interact with the API.

Install curl tool

Test curl is installed properly

curl https://api.elis.rossum.ai/v1

{"organizations":"https://api.elis.rossum.ai/v1/organizations","workspaces":"htt
ps://api.elis.rossum.ai/v1/workspaces","schemas":"https://api.elis.rossum.ai/v1/
schemas","connectors":"https://api.elis.rossum.ai/v1/connectors","inboxes":"http
s://api.elis.rossum.ai/v1/inboxes","queues":"https://api.elis.rossum.ai/v1/queue
s","documents":"https://api.elis.rossum.ai/v1/documents","users":"https://api.el
is.rossum.ai/v1/users","groups":"https://api.elis.rossum.ai/v1/groups","annotati
ons":"https://api.elis.rossum.ai/v1/annotations","pages":"https://api.elis.rossu
m.ai/v1/pages"}

All code samples included in this API documentation use curl, the command line data transfer tool. On MS Windows 10, MacOS X and most Linux distributions, curl should already be pre-installed. If not, please download it from curl.haxx.se).

Optionally use jq tool to pretty-print JSON output

curl https://api.elis.rossum.ai/v1 | jq

{
  "organizations": "https://api.elis.rossum.ai/v1/organizations",
  "workspaces": "https://api.elis.rossum.ai/v1/workspaces",
  "schemas": "https://api.elis.rossum.ai/v1/schemas",
  "connectors": "https://api.elis.rossum.ai/v1/connectors",
  "inboxes": "https://api.elis.rossum.ai/v1/inboxes",
  "queues": "https://api.elis.rossum.ai/v1/queues",
  "documents": "https://api.elis.rossum.ai/v1/documents",
  "users": "https://api.elis.rossum.ai/v1/users",
  "groups": "https://api.elis.rossum.ai/v1/groups",
  "annotations": "https://api.elis.rossum.ai/v1/annotations",
  "pages": "https://api.elis.rossum.ai/v1/pages"
}

You may also want to install jq tool to make curl output human-readable.

Create an account

In order to interact with the API, you need an account. If you do not have one, please contact support@rossum.ai.

Login to the account

Fill-in you username and password. Trigger login endpoint to obtain a key (token), that can be used in subsequent calls.

curl -s -H 'Content-Type: application/json' \
  -d '{"username": "east-west-trading-co@elis.rossum.ai", "password": "aCo2ohghBo8Oghai"}' \
  'https://api.elis.rossum.ai/v1/auth/login'
{"key": "db313f24f5738c8e04635e036ec8a45cdd6d6b03"}

Upload a document

In order to upload a document (PDF of image) through the API, you need to obtain a queue first.

curl -s -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03'
  'https://api.elis.rossum.ai/v1/queues?page_size=1' | jq -r .results[0].url
https://api.elis.rossum.ai/v1/queues/8199

Then you can upload document to the queue. Alternatively, you can send documents to a queue-related inbox. See upload for more information about importing files.

curl -s -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  -F content=@document.pdf 'https://api.elis.rossum.ai/v1/queues/8199/upload' | jq -r .results[0].annotation
https://api.elis.rossum.ai/v1/annotations/319668

Wait for document to be ready and review extracted data

Uploaded document is processed using the Elis Data Extraction API. It may take up to several minutes to process a document. You can check status of the annotation and wait until its status is changed to to_review.

curl -s -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/annotations/319668' | jq .status
"to_review"

Now you can open the Elis web interface elis.rossum.ai to review and confirm extracted data.

Download reviewed data

Now you can export extracted data using the export endpoint of the queue. You can select XML, CSV or JSON format. For CSV, use URL like:

curl -s -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/queues/8199/export?status=exported&format=csv&id=319668'
Invoice number,Invoice Date,PO Number,Due date,Vendor name,Vendor ID,Customer name,Customer ID,Total amount,
2183760194,2018-06-08,PO2231233,2018-06-08,Alza.cz a.s.,02231233,Rossum,05222322,500.00

Logout

Finally you can dispose token safely using logout endpoint:

curl -s -X POST -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/auth/logout'
{"detail":"Successfully logged out."}

Import and Export

Documents may be imported into Elis using the REST API and email gateway. Supported file formats are PDF, png, jpeg

In order to get the best results from Elis the documents should be in A4 format, at least 150 DPI (in case of scans/photos).

Upload

You can upload a document to the queue using upload endpoint with one or more files to be uploaded. As soon as a document is uploaded, data extraction is started.

Upload endpoint supports basic authentication to enable easy integration with third-party systems.

Import by Email

It is also possible to send documents by email using a properly configured inbox that is associated with a queue. Users then only need to know the email address to forward emails to.

For every incoming email, Elis extracts PDF documents and images, stores them in the queue and starts data extraction process.

Small images (up to 100x100 pixels) are ignored, see inbox for reference.

Export

In order to export extracted and confirmed data you can call export endpoint. You can specify status, time-range filters and annotation id list to limit returned results.

Upload endpoint supports basic authentication to enable easy integration with third-party systems.

Auto-split of document

It is possible to process a single PDF file that contains several invoices. Just insert a special separator page between the documents. You can print this page and insert it between documents while scanning.

Elis will recognize a QR code on the page and split the PDF into individual documents automatically. Produced documents are imported to the queue, while the original document is set to a split state.

Document Schema

Every queue has an associated schema that specifies which fields will be extracted from documents as well as the structure of the data sent to connector. Elis schema supports single datapoints (datapoint), lists of datapoints of the same type (multivalue) or tuples (tuple). At the topmost level, each schema consists of sections, which may either directly contain actual data (datapoints) or use nested multivalues and tuples as containers for single datapoints.

Schema content

Schema content consists of a list of section objects.

Common attributes

The following attributes are common for all schema objects:

Attribute	Type	Description	Required
category	string	Category of an object, one of section, multivalue, tuple or datapoint.	yes
id	string	Unique identifier of an object.	yes
label	string	User-friendly label for an object, shown in the user interface	yes

Section

Example of a section:

{
    "category": "section",
    "id": "amounts_section",
    "label": "Amounts",
    "children": [...],
    "icon": ""
}

Section represents a logical part of the document, such as amounts or vendor info. It is allowed only at the top level. Schema allows mutiple sections, and there should be at least one section in the schema.

Attribute	Type	Description	Required
children	list[object]	Specifies objects grouped under a given section. It can contain multivalue or datapoint objects.	yes
icon	string	The icon that appears on the left panel in the UI for a given section (not yet supported on UI).

Datapoint

Example of a datapoint:

{
    "category": "datapoint",
    "id": "invoice_id",
    "label": "Invoice ID",
    "type": "string",
    "default_value": null,
    "rir_field_names": ["invoice_id"],
    "width_chars": 10,
    "constraints": {
        "length": {
            "exact": null,
            "max": 16,
            "min": null
        },
        "regexp": {
            "pattern": ""
        },
        "required": false
    }
}

Datapoint represents single value, typically a field of a document or some global document information.

Attribute	Type	Description	Required
type	string	Data type of the object, must be one of the following: string, number, date, enum	yes
rir_field_names	list[string]	List of names used to initialize content from RIR predictions. If specified, the value of the first extracted field from the array is used, otherwise, no RIR initialization is done for the object.
default_value	string	Default value used either for fields that do not use hints from RIR predictions (i.e. rir_field_names are not specified), or RIR does not return any data for the field.
format	string	Enforces a format for date or number datapoint on the UI. See Date format and Number format.
constraints	object	A map of various constraints for the field. See Value constraints.
options	object	Attribute to specify available options. Only allowed for enum data type. See Enum options.
width_chars	integer	Expected width of content in characters. The client uses this attribute to create appropriate space for the content. Currently not supported in UI.
score_threshold	float [0;1]	Threshold used to validate field content by scores obtained from RIR prediction. These scores represents how confident the model is that the actual result is correct. It may be used to automate validation.
hidden	boolean	If set to true, the datapoint is not visible in the user interface, but remains stored in the database.

Date format

Example number format specification

{
  "id": "item_quantity",
  "type": "number",
  "label": "Quantity",
  "format": "#,##0.#",
  "category": "datapoint",
  ...
}

Example enum datapoint with options

{
  "id": "document_type",
  "type": "enum",
  "label": "Document type",
  "hidden": false,
  "category": "datapoint",
  "options": [
    {
      "label": "Invoice Received",
      "value": "21"
    },
    {
      "label": "Invoice Sent",
      "value": "22"
    },
    {
      "label": "Receipt",
      "value": "23"
    }
  ],
  "width_chars": 10,
  "default_value": "21",
  "rir_field_names": []
}

Example value constraints

{
  "id": "invoice_id",
  "type": "string",
  "label": "Invoice ID",
  "category": "datapoint",
  "constraints": {
    "length": {
      "max": 32,
      "min": 5
    },
    "required": false
  },
  "width_chars": 10,
  "default_value": null,
  "rir_field_names": [
    "invoice_id"
  ]
}

Date format supported: available tokens

Example date formats:

• D/M/YYYY: e.g. 23/1/2019
• MM/DD/YYYY: e.g. 01/23/2019
• YYYY-MM-DD: e.g. 2019-01-23 (ISO date format)

Number format

For number data type, available format choices are # ##0,#, # ##0.#, #,##0.# and null. Default is # ##0.#.

Enum options

Specifies list of available options. Every option consists of an object with keys:

Attribute	Type	Description	Required
value	string	Value of the option.	yes
label	string	User-friendly label for the option, shown in the UI.	yes

Value constraints

Constraints limit allowed values. When constraints is not satisfied, annotation is considered invalid and cannot be exported.

Attribute	Type	Description	Required
length	object	Defines minimum, maximum or exact length for the datapoint value. By default, minimum and maximum are 0 and infinity, respectively. Supported attributes: min, max and exact
regexp	object	When specified, content must match a regular expression. Supported attributes: pattern
required	boolean	Specifies if the datapoint is required by the schema. Default value is true.

Multivalue

Example of a multivalue:

{
  "category": "multivalue",
  "id": "line_item",
  "label": "Line Item",
  "children": {
    ...
  },
  "min_occurrences": null,
  "max_occurrences": null
}

Multivalue is list of datapoints or tuples of the same type. It represents a container for data with multiple occurrences (such as line items) and can contain only objects with the same id.

Attribute	Type	Description	Required
children	object	Object specifying type of children. It can contain only objects with categories tuple or datapoint.	yes
min_occurrences	integer	Minimum number of occurrences of nested objects. Minimum required value for the field is 0. If not specified, it is set to 0 by default.
max_occurrences	integer	Maximum number of occurrences of nested objects. Minimum required value for the field is 1. If not specified, it is set to infinity by default.

Tuple

Example of a tuple:

{
  "category": "tuple",
  "id": "tax_details",
  "label": "Tax Details",
  "children": [
    ...
  ],
  "rir_field_names": [
    "tax_details"
  ]
}

Container representing tabular data with related values, such as tax details. A tuple must be nested within a multivalue object, but unlike multivalue, it may consist of objects with different ids.

Attribute	Type	Description	Required
children	list[object]	Array specifying objects that belong to a given tuple. It can contain only objects with category datapoint.	yes
rir_field_names	list[string]	List of names used to initialize content from RIR predictions. If specified, the value of the first extracted field from the array is used, otherwise, no RIR initialization is done for the object.

Updating Schema

When project evolves, it is a common practice to enhance or change extracted field set. This is done by creating new schema object and linking it to the queue (replacing previous schema object).

Elis supports multiple schema versions at the same time. Every annotation has a related schema that describes its shape and fields. This schema is linked to the annotation as soon as annotation is created or when it is opened in the verification UI. When queue schema object is replaced, annotation data is re-shaped and updated to match to match current queue's schema.

In order to transfer annotation field values properly during the schema update, a datapoint's category and schema_id must be preserved.

Supported operations that preserve fields data are:

• adding a new datapoint (filled from Data Extractor, if available)
• reordering datapoints on the same level
• moving datapoints from section to another section
• moving datapoints to and from a tuple
• reordering datapoints inside a tuple
• making datapoint a multivalue (original datapoint is the only value in a new multivalue container)
• making datapoint non-multivalue (only first datapoint value is preserved)

Document Lifecycle

Each document is submitted to Elis within a given queue. Then it goes through a variety of states as it is processed, and eventually exported.

State	Description
importing	Document is being processed by a neural network data extraction; initial state of the document.
failed_import	Import failed e.g. due to a malformed document file.
to_review	Initial extraction step is done and the document is waiting for user verification.
reviewing	Document is undergoing verification in the user interface.
postponed	Operator has chosen to postpone the document instead of exporting it.
exporting	Document is verified and is awaiting the connector export call.
exported	Document was exported through the connector; this is the typical terminal state of a document.
failed_export	When the connector returned an error.
deleted	When the document was deleted by the user.
purged	Only metadata was preserved after a deletion.

Extensions

Elis DM may be extended by integration of third-party services. Currently we support Connector extension type. We will build on connector functionality and generalize extensions in the future.

Connector Extension

The connector component typically takes care of integration of Elis with client systems that are to receive processed documents. It is called when a document is finally exported and it is also possible to hook it elsewhere in the process - particularly receiving on-the-fly verification callbacks e.g. for supplier matching or other customization purposes.

Connector is designed to be implemented using a push-model using common HTTPS protocol. When annotation data is changed, or when data export is triggered, specific connector endpoint is called with annotation data as a request payload.

Setup a connector

In Elis, a connector object defines service_url for construction of HTTPS requests and authorization_token that is passed in every request to authenticate the caller as the actual Elis server. It may also uniquely identify the organization when multiple Elis organizations share the same connector server.

The authorization token is passed as an Authorizaton HTTP header: Authorization secret_key {authorization_token}

To set-up a connector for a queue, create a connector object with URL of the remote.

Connector may be related to one or more queues.

Connector API

Example data sent to connector (validate, save)

{
  "meta": {
    "document_url": "https://api.elis.rossum.ai/v1/documents/6780",
    "arrived_at": "2019-01-30T07:55:13.208304Z",
    "original_file": "https://api.elis.rossum.ai/v1/original/bf0db41937df8525aa7f3f9b18a562f3",
    "original_filename": "Invoice.pdf",
    "queue_name": "Invoices",
    "workspace_name": "EU",
    "organization_name": "East West Trading Co",
    "annotation": "https://api.elis.rossum.ai/v1/annotations/4710",
    "queue": "https://api.elis.rossum.ai/v1/queues/63",
    "workspace": "https://api.elis.rossum.ai/v1/workspaces/62",
    "organization": "https://api.elis.rossum.ai/v1/organizations/1",
    "modifier": "https://api.elis.rossum.ai/v1/users/27",
    "updated_datapoint_ids": ["197468"]
  },
  "content": [
    {
      "id": "197466",
      "category": "section",
      "schema_id": "invoice_info_section",
      "children": [
        {
          "id": "197467",
          "category": "datapoint",
          "schema_id": "invoice_number",
          "page": 1,
          "position": [916, 168, 1190, 222],
          "value": "FV103828806S",
          "validation_sources": ["score"],
          "type": "string"
        },
        {
          "id": "197468",
          "category": "datapoint",
          "schema_id": "date_due",
          "page": 1,
          "position": [938, 618, 1000, 654],
          "value": "12/22/2018",
          "validation_sources": ["score"],
          "type": "date"
        },
        {
          "id": "197469",
          "category": "datapoint",
          "schema_id": "amount_due",
          "page": 1,
          "position": [1134, 1050, 1190, 1080],
          "value": "55.20",
          "validation_sources": ["human"],
          "type": "number"
        },
      ]
    },
    {
      "id": "197500",
      "category": "section",
      "schema_id": "line_items_section",
      "children": [
        {
          "id": "197501",
          "category": "multivalue",
          "schema_id": "line_items",
          "children": [
            {
              "id": "198139",
              "category": "tuple",
              "schema_id": "line_item",
              "children": [
                {
                  "id": "198140",
                  "category": "datapoint",
                  "schema_id": "item_desc",
                  "page": 1,
                  "position": [173, 883, 395, 904],
                  "value": "Red Rose",
                  "validation_sources": [],
                  "type": "string"
                },
                {
                  "id": "198142",
                  "category": "datapoint",
                  "schema_id": "item_net_unit_price",
                  "page": 1,
                  "position": [714, 846, 768, 870],
                  "value": "1532.02",
                  "validation_sources": ["human"],
                  "type": "number"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

All connector endpoints, representing hooks at particular points in the document lifetime, are simple verbs that receive a JSON POSTed and potentially expect a JSON returned in turn.

Errors

If a connector does not implement an endpoint, it may return HTTP status 404. An endpoint may fail, returning either HTTP 4xx or HTTP 5xx; for some hooks (like validate and save), this may trigger a user interface message; either the error key of a JSON response is used, or the response body itself in case it is not JSON. The connector hook save can be called in asynchronous (default) as well as synchronous mode (useful for embedded mode).

Data format

The received JSON object contains two keys, meta carrying the metadata and content carrying endpoint-specific content.

The metadata identify the concerned document, containing attributes:

Key	Type	Description
document_url	URL	document URL
arrived_at	timestamp	A time time of document arrival in Elis)
original_file	URL	Permanent URL for the document original file
original_filename	string	Filename of the document on arrival in Elis
queue_name	string	Name of the document's queue
workspace_name	string	Name of the document's workspace
organization_name	string	Name of the document's organization
annotation	URL	Annotation URL
queue	URL	Document's queue URL
workspace	URL	Document's workspace URL
organization	URL	Document's organization URL
modifier	URL	Modifier URL

A common class of content is the annotation tree, which is a JSON object that can contain nested datapoint objects, and matches the schema datapoint tree.

Intermediate nodes have the following structure:

Key	Type	Description
id	integer	A unique id of the given node
schema_id	string	Reference mapping the node to the schema tree
category	string	One of section, multivalue, tuple
content	list	A list of other nodes

Datapoint (leaf) nodes structure contains actual data:

Key	Type	Description
id	integer	A unique id of the given node
schema_id	string	Reference mapping the node to the schema tree
category	string	datapoint
type	string	One of string, date or number, as specified in the schema
value	string	The datapoint value, string represented but normalizes, to that they are machine readable: ISO format for dates, a decimal for numbers
page	integer	A 1-based integer index of the page, optional
position	[float]	List of four floats describing the x1, y1, x2, y2 bounding box coordinates

Hook: validate

Example of validate response

{
  "messages": [
    {
      "content": "Invalid invoice number format",
      "id": "197467",
      "type": "error"
    }
  ],
  "updated_datapoints": [
    {
      "id": "198142",
      "value": "1532.00"
    }
  ]
}

This hook is called after operator updates a field in the Elis verification interface.

It may:

• validate the given annotation tree and return a list of messages commenting on it (e.g. pointing out errors or showing matched suppliers).
• update the annotation tree by returning a list of datapoints to update.

Both the messages and the updated datapoints are shown in the verification interface. Moreover, the messages may block export in the case of errors. This hook should be fast as it is part of an interactive workflow.

Receives an annotation tree as content. Returns a JSON object with

1. the messages attribute, being a list of message objects:
   • content (a descriptive message to be shown to user)
   • type - one of error, warning and info (show an error for fatals like a missing required field, whereas you may use info to decorate a supplier company id with its name as looked up in the supplier database)
   • id (optional unique string id of the concerned datapoint, if any; omit for a document-wide and other issues)
2. the updated_datapoints attribute, being a list of datapoint objects:
   • id (a unique id of the concerned datapoint, currently only datapoints of category datapoint can be updated)
   • value (new value of the datapoint)
   • hidden (toggle for hiding(true)/showing(false) the datapoint)
   • options (new options of the datapoint -- valid only for type=enum)
   • position (new position of the datapoint)

It should always return 200 OK status.

An error message returned from the connector prevents user from exporting the document.

Hook: save

This hook is called when the invoice transitions to the exporting state. Connector may process the final document annotation and save it to the target system. It receives an annotation tree as content.

The save hook is called asynchronously (unless synchronous mode is set in related connector object. Timeout of the save hook endpoint is 60 seconds.

It should return an empty response with 204 No Content status for success.

For graceful failure with error message return 422 Unprocessable Entity or 500 Internal Server Error status with response with same format as in validate hook. If the hook fails with an HTTP error, the document transitions to the failed_export state and is available to the operators for review.

Embedded Mode

In some use-cases, it is desirable to use only annotation-related functionality of the Elis document management interface. Elis may be integrated with other systems using so-called embedded mode.

In embedded mode, special URL is constructed and then used in iframe or popup browser window to show Elis annotation view. Some view navigation widgets are hidden (such as home, postpone and delete buttons), so that user is only allowed to update and confirm all field values.

Embedded mode workflow

The host application first uploads a document using standard Elis document management API. During this process, an annotation object is created. It is possible to obtain a status of the annotation object and wait for the status to became to_review (ready for checking) using annotation endpoint.

As soon as importing of the annotation object has finished, an authenticated user may call start_embedded endpoint to obtain a URL that is to be included in iframe or popup browser window of the host application. Parameters of the call are return_url and cancel_url that are used to redirect to in a browser when user finishes the annotation.

The URL contains security token that is used by embedded Elis application to access Elis document management API. When the checking of the document has finished, user clicks on export button and host application is notified about finished annotation through save endpoint of the connector HTTP API. By default, this call is made asynchronously, which causes a lag (up to a few seconds) between the click on export button and the call to save endpoint. However, it is possible to switch the calls to synchronous mode by switching the connector asynchronous toggle to false (see connector for reference).

API Reference

For introduction to the Elis API, see Overview

Most of the API endpoints require user to be authenticated, see Authentication for details.

Organization

Example organization object

{
  "id": 406,
  "url": "https://api.elis.rossum.ai/v1/organizations/406",
  "name": "East West Trading Co",
  "workspaces": [
    "https://api.elis.rossum.ai/v1/workspaces/7540"
  ],
  "users": [
    "https://api.elis.rossum.ai/v1/users/10775"
  ],
  "ui_settings": {},
  "metadata": {}
}

Organization is a basic unit that contains all objects that are required to fully use Elis Document Management system.

Attribute	Type	Default	Description	Read-only
id	integer		Id of the organization	true
name	string		Name of the organization (not visible in UI)
url	URL		URL of the organization	true
workspaces	list[URL]		List of workspaces objects in the organization	true
users	list[URL]		List of users in the organization	true
ui_settings	object	{}	Organization-wide frontend UI settings (e.g. locales). ELIS internal.
metadata	object	{}	Client data, see metadata.

Create new organization

curl -s -X POST -H 'Content-Type: application/json' \
  -d '{"template_name": "UK Demo Template", "organization_name": "East West Trading Co", "user_fullname": "John Doe", "user_email": "john@east-west-trading.com", "user_password": "owo1aiG9ua9Aihai", "user_ui_settings": { "locale": "en" }, "create_key": "13156106d6f185df24648ac7ff20f64f1c5c06c144927be217189e26f8262c4a"}' \
  'https://api.elis.rossum.ai/v1/organizations/create'

{
  "organization": {
    "id": 105,
    "url": "https://api.elis.rossum.ai/v1/organizations/105",
    "name": "East West Trading Co",
    "workspaces": [
      "https://api.elis.rossum.ai/v1/workspaces/160"
    ],
    "users": [
      "https://api.elis.rossum.ai/v1/users/173"
    ],
    "ui_settings": {},
    "metadata": {}
  }
}

POST /v1/organizations/create

Create new organization and related objects (workspace, queue, user, schema, inbox). You need to select a template which affects default schema and extracted fields.

Available templates:

• EU Demo Template: VAT invoices with EU-style bank information
• US Demo Template: Tax invoices in the US and internationally
• UK Demo Template: Also best for India, Canada and Australia
• CZ Demo Template: Czech standard invoices

Attribute	Type	Description
template_name	enum	Template to use for new organization (see above)
organization_name	string	Name of the organization. Will be also used as a base for inbox e-mail address.
user_fullname	string	Full user name
user_email	EMAIL	Valid email of the user (also used as Elis login)
user_password	string	Initial user password
user_ui_settings	object	Initial UI settings, default: { "locale": "en" }
create_key	string	A key that allows to create an organization

You need a create_key in order to create an organization. Please contact support@rossum.ai to obtain one.

Response

Status: 200

Returns object with organization key and organization object value.

List all organizations

List all organizations

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/organizations'

{
  "pagination": {
    "total": 1,
    "total_pages": 1,
    "next": null,
    "previous": null
  },
  "results": [
    {
      "id": 406,
      "url": "https://api.elis.rossum.ai/v1/organizations/406",
      "name": "East West Trading Co",
      "workspaces": [
        "https://api.elis.rossum.ai/v1/workspaces/7540"
      ],
      "users": [
        "https://api.elis.rossum.ai/v1/users/10775"
      ],
      "ui_settings": {},
      "metadata": {}
    }
  ]
}

GET /v1/organizations

Retrieve all organization objects.

Supported filters: name

Supported ordering: id, name

Response

Status: 200

Returns paginated response with a list of organization objects. Usually, there would only be one organization.

Retrieve a organization

Get organization object 406

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/organizations/406'

{
  "id": 406,
  "url": "https://api.elis.rossum.ai/v1/organizations/406",
  "name": "East West Trading Co",
  "workspaces": [
    "https://api.elis.rossum.ai/v1/workspaces/7540"
  ],
  "users": [
    "https://api.elis.rossum.ai/v1/users/10775"
  ],
  "ui_settings": {},
  "metadata": {}
}

GET /v1/organizations/{id}

Get an organization object.

Response

Status: 200

Returns organization object.

User

Example user object

{
  "id": 10775,
  "url": "https://api.elis.rossum.ai/v1/users/10775",
  "first_name": "John",
  "last_name": "Doe",
  "email": "john-doe@east-west-trading.com",
  "date_joined": "2018-09-19T13:44:56.000000Z",
  "username": "john-doe@east-west-trading.com",
  "groups": [
    "https://api.elis.rossum.ai/v1/groups/3"
  ],
  "organization": "https://api.elis.rossum.ai/v1/organizations/406",
  "queues": [
    "https://api.elis.rossum.ai/v1/queues/8199"
  ],
  "is_active": true,
  "last_login": "2019-02-07T16:20:18.652253Z",
  "ui_settings": {}
}

A user object represents individual user of Elis. Every user is assigned to an organization.

A user can be assigned User role (permission groups): viewer, annotator, admin.

User may be assigned to one or more queues and can only access annotations from the assigned queues. This restriction is not applied to admin users, who may access annotations from all queues.

Users cannot be deleted, but can be disabled (set is_active to false).

Attribute	Type	Default	Description	Read-only
id	integer		Id of the user	true
url	URL		URL of the user	true
first_name	string		First name of the user
last_name	string		Last name of the user
email	string		Email of the user
date_joined	datetime		Date of user join
username	string		Username of a user
groups	list[URL]	[]	List of user role (permission groups)
organization	URL		Related organization
queues	list[URL]	[]	List of queues user is assigned to.
is_active	bool	true	Whether user is enabled or disabled
last_login	datetime		Date of last login
ui_settings	object	{}	User-related frontend UI settings (e.g. locales). ELIS internal.

List all users

List all users in the organization.

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/users'

{
  "pagination": {
    "total": 1,
    "total_pages": 1,
    "next": null,
    "previous": null
  },
  "results": [
    {
      "id": 10775,
      "url": "https://api.elis.rossum.ai/v1/users/10775",
      "first_name": "John",
      "last_name": "Doe",
      "email": "john-doe@east-west-trading.com",
      "date_joined": "2018-09-19T13:44:56.000000Z",
      "username": "john-doe@east-west-trading.com",
      ...
    }
  ]
}

GET /v1/users

Retrieve all user objects.

Supported filters: organization, username, first_name, last_name, email, is_active, last_login

Supported ordering: id, username, first_name, last_name, email, last_login, date_joined

Response

Status: 200

Returns paginated response with a list of user objects.

Create new user

Create new user in organization 406

curl -s -X POST -H 'Content-Type: application/json' -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  -d '{"organization": "https://api.elis.rossum.ai/v1/organizations/406", "username": "jane@east-west-trading.com", "password": "Mie0yiot", "queues": ["https://api.elis.rossum.ai/v1/queues/8236"], "groups": ["https://api.elis.rossum.ai/v1/groups/2"]}' \
  'https://api.elis.rossum.ai/v1/users'

{
  "id": 10997,
  "url": "https://api.elis.rossum.ai/v1/users/10997",
  "first_name": "",
  "last_name": "",
  "email": "",
  "date_joined": "2019-02-09T22:16:38.969904Z",
  "username": "jane@east-west-trading.com",
  "groups": [
    "https://api.elis.rossum.ai/v1/groups/2"
  ],
  "organization": "https://api.elis.rossum.ai/v1/organizations/406",
  "queues": [
    "https://api.elis.rossum.ai/v1/queues/8236"
  ],
  "is_active": true,
  "last_login": null,
  "ui_settings": {}
}

POST /v1/users

Create a new user object.

Response

Status: 201

Returns created user object.

Retrieve a user

Get user object 10997

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/users/10997'

{
  "id": 10997,
  "url": "https://api.elis.rossum.ai/v1/users/10997",
  "first_name": "Jane",
  "last_name": "Bond",
  "email": "",
  "date_joined": "2019-02-09T22:16:38.969904Z",
  "username": "jane@east-west-trading.com",
  ...
}

GET /v1/users/{id}

Get a user object.

Response

Status: 200

Returns user object.

Update a user

Update user object 10997

curl -s -X PUT -H 'Content-Type: application/json' -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  -d '{"organization": "https://api.elis.rossum.ai/v1/organizations/406", "username": "jane@east-west-trading.com", "password": "quaa3Ahc", "queues": ["https://api.elis.rossum.ai/v1/queues/8236"], "groups": ["https://api.elis.rossum.ai/v1/groups/2"], "first_name": "Jane"}' \
  'https://api.elis.rossum.ai/v1/users/10997'

{
  "id": 10997,
  "url": "https://api.elis.rossum.ai/v1/users/10997",
  "first_name": "Jane",
  "last_name": "",
  "email": "",
  ...
}

PUT /v1/users/{id}

Update user object.

Response

Status: 200

Returns updated user object.

Update part of a user

Update email of user object 10997

curl -X PATCH -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"first_name": "Emma"}' \
  'https://api.elis.rossum.ai/v1/users/10997'

{
  "id": 10997,
  "url": "https://api.elis.rossum.ai/v1/users/10997",
  "first_name": "Emma",
  "last_name": "",
  ...
}

PATCH /v1/users/{id}

Update part of user object.

Response

Status: 200

Returns updated user object.

User Role

Example role object

{
  "url": "https://api.elis.rossum.ai/v1/groups/3",
  "name": "admin"
}

User role is a group of permissions that are assigned to the user. Permissions are assigned to individual operations on objects.

Attribute	Type	Default	Description	Read-only
url	URL		URL of the user role	true
name	string		Name oft the user role	true

There are three pre-defined roles:

Role	Description
viewer	Read-only user, cannot change any API object. Not supported in Elis UI. May be useful for automated data export.
annotator	User that is allowed to change annotation, its datapoints and import a document.
admin	User can modify API objects to set-up organization (e.g. workspaces, queues, schemas)

User can only access annotations from queues it is assigned to, with the exception of admin role that can access any queue.

Permissions assigned to the role cannot be changed through the API.

List all user roles

List all user roles (groups)

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/groups'

{
  "pagination": {
    "total": 3,
    "total_pages": 1,
    "next": null,
    "previous": null
  },
  "results": [
    {
      "url": "https://api.elis.rossum.ai/v1/groups/1",
      "name": "viewer"
    },
    {
      "url": "https://api.elis.rossum.ai/v1/groups/2",
      "name": "annotator"
    },
    {
      "url": "https://api.elis.rossum.ai/v1/groups/3",
      "name": "admin"
    }
  ]
}

GET /v1/groups

Retrieve all organization objects.

Supported filters: name

Supported ordering: name

Response

Status: 200

Returns paginated response with a list of group objects.

Retrieve a user role

Get group object 2

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/groups/2'

{
  "url": "https://api.elis.rossum.ai/v1/groups/2",
  "name": "annotator"
}

GET /v1/groups/{id}

Get a user role object.

Response

Status: 200

Returns group object.

Workspace

Example workspace object

{
  "id": 7540,
  "name": "East West Trading Co",
  "url": "https://api.elis.rossum.ai/v1/workspaces/7540",
  "autopilot": true,
  "organization": "https://api.elis.rossum.ai/v1/organizations/406",
  "queues": [
    "https://api.elis.rossum.ai/v1/queues/8199",
    "https://api.elis.rossum.ai/v1/queues/8236"
  ],
  "metadata": {}
}

A workspace object is a container of queue objects.

Attribute	Type	Default	Description	Read-only
id	integer		Id of the workspace	true
name	string		Name of the workspace
url	URL		URL of the workspace	true
autopilot	bool	false	Whether to automatically confirm datapoints (hide eyes) from previously seen annotations
organization	URL		Related organization
queues	list[URL]	[]	List of queues that belongs to the workspace	true
metadata	object	{}	Client data, see metadata.

List all workspaces

List all workspaces

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/workspaces'

{
  "pagination": {
    "total": 1,
    "total_pages": 1,
    "next": null,
    "previous": null
  },
  "results": [
    {
      "id": 7540,
      "name": "East West Trading Co",
      "url": "https://api.elis.rossum.ai/v1/workspaces/7540",
      "autopilot": true,
      "organization": "https://api.elis.rossum.ai/v1/organizations/406",
      "queues": [
        "https://api.elis.rossum.ai/v1/queues/8199",
        "https://api.elis.rossum.ai/v1/queues/8236"
      ],
      "metadata": {}
    }
  ]
}

GET /v1/workspaces

Retrieve all workspace objects.

Supported filters: organization, autopilot

Supported ordering: id, name

Response

Status: 200

Returns paginated response with a list of workspace objects.

Create a new workspace

Create new workspace in organization 406 named Test Workspace

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"name": "Test Workspace", "organization": "https://api.elis.rossum.ai/v1/organizations/406"}' \
  'https://api.elis.rossum.ai/v1/workspaces'

{
  "id": 7694,
  "name": "Test Workspace",
  "url": "https://api.elis.rossum.ai/v1/workspaces/7694",
  "autopilot": false,
  "organization": "https://api.elis.rossum.ai/v1/organizations/406",
  "queues": [],
  "metadata": {}
}

POST /v1/workspaces

Create a new workspace object.

Response

Status: 201

Returns created workspace object.

Retrieve a workspace

Get workspace object 7694

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/workspaces/7694'

{
  "id": 7694,
  "name": "Test Workspace",
  "url": "https://api.elis.rossum.ai/v1/workspaces/7694",
  "autopilot": false,
  "organization": "https://api.elis.rossum.ai/v1/organizations/406",
  "queues": [],
  "metadata": {}
}

GET /v1/workspaces/{id}

Get an workspace object.

Response

Status: 200

Returns workspace object.

Update a workspace

Update workspace object 7694

curl -X PUT -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"name": "My Workspace", "organization": "https://api.elis.rossum.ai/v1/organizations/406"}' \
  'https://api.elis.rossum.ai/v1/workspaces/7694'

{
  "id": 7694,
  "name": "My Workspace",
  "url": "https://api.elis.rossum.ai/v1/workspaces/7694",
  "autopilot": false,
  "organization": "https://api.elis.rossum.ai/v1/organizations/406",
  "queues": [],
  "metadata": {}
}

PUT /v1/workspaces/{id}

Update workspace object.

Response

Status: 200

Returns updated workspace object.

Update part of a workspace

Update name of workspace object 7694

curl -X PATCH -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"name": "Important Workspace"}' \
  'https://api.elis.rossum.ai/v1/workspaces/7694'

{
  "id": 7694,
  "name": "Important Workspace",
  "url": "https://api.elis.rossum.ai/v1/workspaces/7694",
  "autopilot": false,
  "organization": "https://api.elis.rossum.ai/v1/organizations/406",
  "queues": [],
  "metadata": {}
}

PATCH /v1/workspaces/{id}

Update part of workspace object.

Response

Status: 200

Returns updated workspace object.

Delete a workspace

Delete workspace 7694

curl -X DELETE -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/workspaces/7694'

DELETE /v1/workspaces/{id}

Delete workspace object.

Response

Status: 204

Queue

Example queue object

{
  "id": 8198,
  "name": "Received invoices",
  "url": "https://api.elis.rossum.ai/v1/queues/8198",
  "workspace": "https://api.elis.rossum.ai/v1/workspaces/7540",
  "connector": null,
  "schema": "https://api.elis.rossum.ai/v1/schemas/31336",
  "inbox": "https://api.elis.rossum.ai/v1/inboxes/1229",
  "users": [
    "https://api.elis.rossum.ai/v1/users/10775"
  ],
  "session_timeout": "01:00:00",
  "rir_url": "https://all.rir.rossum.ai",
  "counts": {
    "importing": 0,
    "split": 0,
    "failed_import": 0,
    "to_review": 2,
    "reviewing": 0,
    "exporting": 0,
    "postponed": 0,
    "failed_export": 0,
    "exported": 0,
    "deleted": 0,
    "purged": 0
  },
  "default_score_threshold": null,
  "automation_enabled": false,
  "locale": "en_US",
  "metadata": {}
}

A queue object represents a basic organization unit of annotations. Annotations are imported to a queue either through a REST API upload endpoint or by sending an email to a related inbox. Export is also performed on a queue using export endpoint.

Queue also specifies a schema for annotations and a connector.

Annotators and viewers only see queues they are assigned to.

Attribute	Type	Default	Description	Read-only
id	integer		Id of the queue	true
name	string		Name of the queue
url	URL		URL of the queue	true
workspace	URL		Workspace in which the queue should be placed
connector	URL	null	Connector associated with the queue
schema	URL		Schema which will be applied to annotations in this queue
inbox	URL	null	Inbox for import to this queue
users	list[URL]	[]	Users associated with this queue
session_timeout	timedelta	1 hour	Time before annotation will be returned from revieving status to to_review
rir_url	URL	null	URL of the Extraction API used for document processing. Usually https://all.rir.rossum.ai.
counts	object		Count of annotations per status	true
default_score_threshold	float [0;1]	null	Confidence level above which will be fields of annotation considered suitable for automation
automation_enabled	bool	false	Toggle for switching automation on/off
locale	string	en_GB	Locale sent to Extraction API
metadata	object	{}	Client data, see metadata.

Import a document

Upload file using a form (multipart/form-data)

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  -F content=@document.pdf \
  'https://api.elis.rossum.ai/v1/queues/8236/upload'

Upload file in a request body

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  -H 'Content-Disposition: attachment; filename=document.pdf' --data-binary @file.pdf \
  'https://api.elis.rossum.ai/v1/queues/8236/upload'

Upload file in a request body with a filename in URL

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  --data-binary @file.pdf \
  'https://api.elis.rossum.ai/v1/queues/8236/upload/document.pdf'

Upload multiple files using multipart/form-data

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  -F content=@document1.pdf -F content=@document2.pdf \
  'https://api.elis.rossum.ai/v1/queues/8236/upload'

Upload file using basic authentication

curl -u 'east-west-trading-co@elis.rossum.ai:secret' \
  -F content=@document.pdf \
  'https://api.elis.rossum.ai/v1/queues/8236/upload'

POST /v1/queues/{id}/upload

POST /v1/queues/{id}/upload/{filename}

Uploads a document to the queue (starting in the importing state). This creates a document object and an empty annotation object.

The file can be sent as a part of multipart/form-data or, alternatively, in the request body. Multiple files upload is supported, the total size of the data uploaded may not exceed 40 MB.

Upload endpoint also supports basic authentication to enable easy integration with third-party systems.

Response

Status: 200

Response contains a list of annotations and documents created. Top-level keys annotation and document are obsolete and should be ignored.

Example upload response

{
  "results": [
    {
      "annotation": "https://api.elis.rossum.ai/v1/annotations/315509",
      "document": "https://api.elis.rossum.ai/v1/documents/315609"
    }
    {
      "annotation": "https://api.elis.rossum.ai/v1/annotations/315510",
      "document": "https://api.elis.rossum.ai/v1/documents/315610"
    }
  ],
  "annotation": "https://api.elis.rossum.ai/v1/annotations/315509",
  "document": "https://api.elis.rossum.ai/v1/documents/315609"
}

Export annotations

Download CSV file with selected columns from annotations 315777 and 315778.

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/inboxs/8236/export?format=csv&columns=meta_file_name,invoice_id,date_issue,amount_total&id=315777,315778'

meta_file_name,Invoice number,Invoice Date,Total amount
template_invoice.pdf,12345,2017-06-01,900.00
alza.pdf,2183760194,2018-08-06,500.00

Download XML file with all exported annotations

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/queues/8236/export?format=xml&status=exported'

<?xml version="1.0" encoding="utf-8"?>
<export>
  <results>
    <annotation url="https://api.elis.rossum.ai/v1/annotations/315777">
      <status>exported</status>
      <arrived_at>2019-02-07T21:33:01.509886Z</arrived_at>
      <exported_at>2019-02-08T12:00:01.000133Z</exported_at>
      <document url="https://api.elis.rossum.ai/v1/documents/315877">
        <file_name>template_invoice.pdf</file_name>
        <file>https://api.elis.rossum.ai/v1/documents/315877/content</file>
      </document>
      <modifier/>
      <schema url="https://api.elis.rossum.ai/v1/schemas/31336"/>
      <metadata/>
      <content>
        <section schema_id="invoice_details_section">
          <datapoint schema_id="invoice_id" type="string">12345</datapoint>
          ...
        </section>
      </content>
    </annotation>
  </results>
  <pagination>
    <next/>
    <previous/>
    <total>1</total>
    <total_pages>1</total_pages>
  </pagination>
</export>

Download JSON file with all exported annotations that were imported on February 2nd 2019.

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/queues/8236/export?format=json&status=exported&arrived_at_after=2019-02-02&arrived_at_before=2019-02-03'

{
  "pagination": {
    "total": 5,
    "total_pages": 1,
    "next": null,
    "previous": null
  },
  "results": [
    {
      "url": "https://api.elis.rossum.ai/v1/annotations/315777",
      "status": "exported",
      "arrived_at": "2019-02-07T21:33:01.509886Z",
      "exported_at": "2019-02-08T12:00:01.000133Z",
      "document": {
        "url": "https://api.elis.rossum.ai/v1/documents/315877",
        "file_name": "template_invoice.pdf",
        "file": "https://api.elis.rossum.ai/v1/documents/315877/content"
      },
      "modifier": null,
      "schema": {
        "url": "https://api.elis.rossum.ai/v1/schemas/31336"
      },
      "metadata": {},
      "content": [
        {
          "category": "section",
          "schema_id": "invoice_details_section",
          "children": [
            {
              "category": "datapoint",
              "schema_id": "invoice_id",
              "value": "12345",
              "type": "string"
            },
            ...
          ]
        }
      ]
    }
  ]
}

GET /v1/queues/{id}/export

Export annotations from the queue in XML, CSV or JSON format.

Output format is negotiated by Accept header or format parameter. Supported formats are: csv, xml and json.

Filters

Filters may be specified to limit annotations to be exported, all filters applicable to the annotation list are supported.

The most common filters are either list of ids or specifying a time period:

Attribute	Description
id	Id of annotation to be exported, multiple ids may be separated by a comma.
status	Annotation status
modifier	User id
arrived_at_before	ISO 8601 timestamp (e.g. arrived_at_before=2019-11-05)
arrived_at_after	ISO 8601 timestamp (e.g. arrived_at_after=2019-11-04)
exported_at_before	ISO 8601 timestamp (e.g. exported_at_before=2019-11-04 22:00:00)
exported_at_after	ISO 8601 timestamp (e.g. exported_at_after=2019-11-04 12:00:00)

Response

Status: 200

Returns paginated response that contains annotation data in one of the following format.

CSV

Columns included in CSV output are defined by columns URL parameter. Columns are specified by datapoint schema ids and meta-columns. Default is to export all fields defined in a schema.

Supported meta-columns are: meta_arrived_at, meta_file, meta_file_name, meta_status, meta_url.

XML

XML format is described by XML Schema Definition queues_export.xsd.

JSON

JSON format uses format similar to the XML format above.

List all queues

List all queues in workspace 7540 ordered by name

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/queues?workspace=7540&ordering=name'

{
  "pagination": {
    "total": 2,
    "total_pages": 1,
    "next": null,
    "previous": null
  },
  "results": [
    {
      "id": 8199,
      "name": "Receipts",
      "url": "https://api.elis.rossum.ai/v1/queues/8199",
      "workspace": "https://api.elis.rossum.ai/v1/workspaces/7540",
      ...
    },
    {
      "id": 8198,
      "name": "Received invoices",
      "url": "https://api.elis.rossum.ai/v1/queues/8198",
      "workspace": "https://api.elis.rossum.ai/v1/workspaces/7540",
      ...
    }
  ]
}

GET /v1/queues

Retrieve all queue objects.

Supported ordering: id, name, workspace, connector,schema, inbox, locale

Filters

Attribute	Description
name	Name of a queue
workspace	Id of a workspace
inbox	Id of an inbox
connector	Id of a connector
locale	Queue object locale

Response

Status: 200

Returns paginated response with a list of queue objects.

Create new queue

Create new queue in workspace 7540 named Test Queue

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"name": "Test Queue", "workspace": "https://api.elis.rossum.ai/v1/workspaces/7540", "schema": "https://api.elis.rossum.ai/v1/schemas/31336"}' \
  'https://api.elis.rossum.ai/v1/queues'

{
  "id": 8236,
  "name": "Test Queue",
  "url": "https://api.elis.rossum.ai/v1/queues/8236",
  "workspace": "https://api.elis.rossum.ai/v1/workspaces/7540",
  ...
}

POST /v1/queues

Create a new queue object.

Response

Status: 201

Returns created queue object.

Retrieve a queue

Get queue object 8198

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/queues/8198'

{
  "id": 8198,
  "name": "Received invoices",
  "url": "https://api.elis.rossum.ai/v1/queues/8198",
  "workspace": "https://api.elis.rossum.ai/v1/workspaces/7540",
  ...
}

GET /v1/queues/{id}

Get a queue object.

Response

Status: 200

Returns queue object.

Update a queue

Update queue object 8236

curl -X PUT -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"name": "My Queue", "workspace": "https://api.elis.rossum.ai/v1/workspaces/7540", "schema": "https://api.elis.rossum.ai/v1/schemas/31336"}' \
  'https://api.elis.rossum.ai/v1/queues/8236'

{
  "id": 8236,
  "name": "My Queue",
  "url": "https://api.elis.rossum.ai/v1/queues/8236",
  "workspace": "https://api.elis.rossum.ai/v1/workspaces/7540",
  ...
}

PUT /v1/queues/{id}

Update queue object.

Response

Status: 200

Returns updated queue object.

Update part of a queue

Update name of queue object 8236

curl -X PATCH -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"name": "New Queue"}' \
  'https://api.elis.rossum.ai/v1/queues/8236'

{
  "id": 8236,
  "name": "New Queue",
  "url": "https://api.elis.rossum.ai/v1/queues/8236",
  "workspace": "https://api.elis.rossum.ai/v1/workspaces/7540",
  ...
}

PATCH /v1/queues/{id}

Update part of queue object.

Response

Status: 200

Returns updated queue object.

Delete a queue

Delete queue 8236

curl -X DELETE -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/queues/8236'

DELETE /v1/queues/{id}

Delete queue object.

Response

Status: 204

Assign annotation

POST /v1/queues/{id}/next

Assign calling user an available annotation from the queue.

This endpoint is INTERNAL and may change in the future.

Inbox

Example inbox object

{
  "id": 1234,
  "name": "Receipts",
  "url": "https://api.elis.rossum.ai/v1/inboxes/1234",
  "queues": [
    "https://api.elis.rossum.ai/v1/queues/8199"
  ],
  "email": "east-west-trading-co-a34f3a@elis.rossum.ai",
  "email_prefix": "east-west-trading-co",
  "bounce_email_to": "bounces@east-west.com",
  "bounce_unprocessable_attachments": false,
  "bounce_deleted_annotations": false,
  "metadata": {}
}

An inbox object enables email ingestion to a related queue. We enforce email domain to match Elis domain (e.g. elis.rossum.ai). email_prefix may be used to construct unique email address.

Attribute	Type	Default	Description	Read-only
id	integer		Id of the inbox	true
name	string		Name of the inbox (not visible in UI)
url	URL		URL of the inbox	true
queues	list[URL]		List of queues that receive documents from inbox. Usually there is one inbox per queue.
email	EMAIL		Elis email address (e.g. east-west-trading-co-a34f3a@elis.rossum.ai)
email_prefix	string		Elis email address prefix (e.g. east-west-trading-co)
bounce_email_to	EMAIL		Email address to send notifications to (e.g. about failed import).
bounce_unprocessable_attachments	bool	false	Whether return back unprocessable attachments (e.g. MS Word docx) or just silently ignore them.
bounce_postponed_annotations	bool	false	Whether to send notification when annotation is postponed.
bounce_deleted_annotations	bool	false	Whether to send notification when annotation is deleted.
metadata	object	{}	Client data, see metadata.

List all inboxes

List all inboxes in workspace 7540 ordered by name

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/inboxes'

{
  "pagination": {
    "total": 2,
    "total_pages": 1,
    "next": null,
    "previous": null
  },
  "results": [
    {
      "id": 1234,
      "name": "Receipts",
      "url": "https://api.elis.rossum.ai/v1/inboxes/1234",
      "queues": [
        "https://api.elis.rossum.ai/v1/queues/8199"
      ],
      "email": "east-west-trading-co-recepits@elis.rossum.ai",
      "email_prefix": "east-west-trading-co-recepits",
      "bounce_email_to": "bounces@east-west.com",
      "bounce_unprocessable_attachments": false,
      "bounce_deleted_annotations": false,
      "metadata": {}
    },
    {
      "id": 1244,
      "name": "Beta Inbox",
      "url": "https://api.elis.rossum.ai/v1/inboxes/1244",
      "queues": [
        "https://api.elis.rossum.ai/v1/queues/8236"
      ],
      "email": "east-west-trading-co-beta@elis.rossum.ai",
      "email_prefix": "east-west-trading-co-beta",
      "bounce_email_to": "bill@east-west.com",
      "bounce_unprocessable_attachments": false,
      "bounce_deleted_annotations": false,
      "metadata": {}
    }
  ]
}

GET /v1/inboxes

Retrieve all inbox objects.

Supported filters: email, email_prefix, bounce_email_to, bounce_unprocessable_attachments, bounce_postponed_annotations, bounce_deleted_annotations

Supported ordering: id, name, email, email_prefix, bounce_email_to

Response

Status: 200

Returns paginated response with a list of inbox objects.

Create a new inbox

Create new inbox related to queue 8236 named Test Inbox

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"name": "Test Inbox", "email_prefix": "east-west-trading-co-test", "bounce_email_to": "joe@east-west-trading.com", "queues": ["https://api.elis.rossum.ai/v1/queues/8236"]}' \
  'https://api.elis.rossum.ai/v1/inboxes'

{
  "id": 1244,
  "name": "Test Inbox",
  "url": "https://api.elis.rossum.ai/v1/inboxes/1244",
  "queues": [
    "https://api.elis.rossum.ai/v1/queues/8236"
  ],
  "email": "east-west-trading-co-test-b21e3a@elis.rossum.ai",
  "email_prefix": "east-west-trading-co-test",
  "bounce_email_to": "joe@east-west-trading.com",
  "bounce_unprocessable_attachments": false,
  "bounce_postponed_annotations": false,
  "bounce_deleted_annotations": false,
  "metadata": {}
}

POST /v1/inboxes

Create a new inbox object.

Response

Status: 201

Returns created inbox object.

Retrieve a inbox

Get inbox object 1244

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/inboxes/1244'

{
  "id": 1244,
  "name": "Test Inbox",
  "url": "https://api.elis.rossum.ai/v1/inboxes/1244",
  "queues": [
    "https://api.elis.rossum.ai/v1/queues/8236"
  ],
  "email": "east-west-trading-co-beta@elis.rossum.ai",
  ...
}

GET /v1/inboxes/{id}

Get an inbox object.

Response

Status: 200

Returns inbox object.

Update a inbox

Update inbox object 1244

curl -X PUT -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"name": "Shiny Inbox", "email": "east-west-trading-co-test@elis.rossum.ai", "bounce_email_to": "jack@east-west-trading.com", "queues": ["https://api.elis.rossum.ai/v1/queues/8236"]}' \
  'https://api.elis.rossum.ai/v1/inboxes/1244'

{
  "id": 1244,
  "name": "Shiny Inbox",
  "url": "https://api.elis.rossum.ai/v1/inboxes/1244",
  "queues": [
    "https://api.elis.rossum.ai/v1/queues/8236"
  ],
  "email": "east-west-trading-co-test@elis.rossum.ai",
  "bounce_email_to": "jack@east-west-trading.com",
  ...
}

PUT /v1/inboxes/{id}

Update inbox object.

Response

Status: 200

Returns updated inbox object.

Update part of a inbox

Update email of inbox object 1244

curl -X PATCH -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"name": "Common Inbox"}' \
  'https://api.elis.rossum.ai/v1/inboxes/1244'

{
  "id": 1244,
  "name": "Common Inbox",
  ...
}

PATCH /v1/inboxes/{id}

Update part of inbox object.

Response

Status: 200

Returns updated inbox object.

Delete a inbox

Delete inbox 1244

curl -X DELETE -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/inboxes/1244'

DELETE /v1/inboxes/{id}

Delete inbox object.

Response

Status: 204

Connector

Example connector object

{
  "id": 1500,
  "name": "MyQ Connector",
  "queues": [
    "https://api.elis.rossum.ai/v1/queues/8199"
  ],
  "url": "https://api.elis.rossum.ai/v1/connectors/1500",
  "service_url": "https://myq.east-west-trading.com",
  "authorization_token": "wuNg0OenyaeK4eenOovi7aiF",
  "asynchronous": true,
  "metadata": {}
}

A connector is an extension of Elis that allows to validate and modify data during validation and also export data to an external system. A connector object is used to configure external or internal endpoint of such an extension service. For more information see Connectors.

Attribute	Type	Default	Description	Read-only
id	integer		Id of the connector	true
name	string		Name of the connector (not visible in UI)
url	URL		URL of the connector	true
queues	list[URL]		List of queues that use connector object.
service_url	URL		URL of the connector endpoint
authorization_token	string		Token sent to connector in Authorization: token {authorization_token} header to ensure connector was contacted by Elis (displayed only to admin user).
asynchronous	bool	true	Affects exporting: when true, confirm endpoint returns immediately and connector's save endpoint is called asynchronously later on.
metadata	object	{}	Client data, see metadata.

List all connectors

List all connectors

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/connectors'

{
  "pagination": {
    "total": 1,
    "total_pages": 1,
    "next": null,
    "previous": null
  },
  "results": [
    {
      "id": 1500,
      "name": "MyQ Connector",
      "queues": [
        "https://api.elis.rossum.ai/v1/queues/8199"
      ],
      "url": "https://api.elis.rossum.ai/v1/connectors/1500",
      "service_url": "https://myq.east-west-trading.com",
      "authorization_token": "wuNg0OenyaeK4eenOovi7aiF",
      "asynchronous": true,
      "metadata": {}
    }
  ]
}

GET /v1/connectors

Retrieve all connector objects.

Supported filters: name, service_url

Supported ordering: id, name, service_url

Response

Status: 200

Returns paginated response with a list of connector objects.

Create a new connector

Create new connector related to queue 8199 with endpoint URL https://myq.east-west-trading.com

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"name": "MyQ Connector", "queues": ["https://api.elis.rossum.ai/v1/queues/8199"], "service_url": "https://myq.east-west-trading.com", "authorization_token":"wuNg0OenyaeK4eenOovi7aiF"}' \
  'https://api.elis.rossum.ai/v1/connectors'

{
  "id": 1500,
  "name": "MyQ Connector",
  "queues": [
    "https://api.elis.rossum.ai/v1/queues/8199"
  ],
  "url": "https://api.elis.rossum.ai/v1/connectors/1500",
  "service_url": "https://myq.east-west-trading.com",
  "authorization_token": "wuNg0OenyaeK4eenOovi7aiF",
  "asynchronous": true,
  "metadata": {}
}

POST /v1/connectors

Create a new connector object.

Response

Status: 201

Returns created connector object.

Retrieve a connector

Get connector object 1500

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/connectors/1500'

{
  "id": 1500,
  "name": "MyQ Connector",
  "queues": [
    "https://api.elis.rossum.ai/v1/queues/8199"
  ],
  "url": "https://api.elis.rossum.ai/v1/connectors/1500",
  "service_url": "https://myq.east-west-trading.com",
  "authorization_token": "wuNg0OenyaeK4eenOovi7aiF",
  "asynchronous": true,
  "metadata": {}
}

GET /v1/connectors/{id}

Get an connector object.

Response

Status: 200

Returns connector object.

Update a connector

Update connector object 1500

curl -X PUT -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"name": "MyQ Connector (stg)", "queues": ["https://api.elis.rossum.ai/v1/queues/8199"], "service_url": "https://myq.stg.east-west-trading.com", "authorization_token":"wuNg0OenyaeK4eenOovi7aiF"} \
  'https://api.elis.rossum.ai/v1/connectors/1500'

{
  "id": 1500,
  "name": "MyQ Connector (stg)",
  "queues": [
    "https://api.elis.rossum.ai/v1/queues/8199"
  ],
  "url": "https://api.elis.rossum.ai/v1/connectors/1500",
  "service_url": "https://myq.stg.east-west-trading.com",
  "authorization_token": "wuNg0OenyaeK4eenOovi7aiF",
  "asynchronous": true,
  "metadata": {}
}

PUT /v1/connectors/{id}

Update connector object.

Response

Status: 200

Returns updated connector object.

Update part of a connector

Update connector URL of connector object 1500

curl -X PATCH -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"service_url": "https://myq.stg2.east-west-trading.com"}' \
  'https://api.elis.rossum.ai/v1/connectors/1500'

{
  "id": 1500,
  "name": "MyQ Connector",
  "queues": [
    "https://api.elis.rossum.ai/v1/queues/8199"
  ],
  "url": "https://api.elis.rossum.ai/v1/connectors/1500",
  "service_url": "https://myq.stg2.east-west-trading.com",
  "authorization_token": "wuNg0OenyaeK4eenOovi7aiF",
  "asynchronous": true,
  "metadata": {}
}

PATCH /v1/connectors/{id}

Update part of connector object.

Response

Status: 200

Returns updated connector object.

Delete a connector

Delete connector 1500

curl -X DELETE -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/connectors/1500'

DELETE /v1/connectors/{id}

Delete connector object.

Response

Status: 204

Schema

Example schema object

{
  "id": 31336,
  "name": "Basic Schema",
  "queues": [
    "https://api.elis.rossum.ai/v1/queues/8236"
  ],
  "url": "https://api.elis.rossum.ai/v1/schemas/31336",
  "content": [
    {
      "category": "section",
      "id": "invoice_details_section",
      "label": "Invoice details",
      "children": [
        {
          "category": "datapoint",
          "id": "invoice_id",
          "label": "Invoice number",
          "type": "string",
          "width_chars": 10,
          "rir_field_names": [
            "invoice_id"
          ],
          "constraints": {
            "required": false
          },
          "default_value": null
        }
        ...
      ]
    },
    ...
  ],
  "metadata": {}
}

A schema object specifies the set of datapoints that are extracted from the document. For more information see Document Schema.

Attribute	Type	Default	Description	Read-only
id	integer		Id of the schema	true
name	string		Name of the schema (not visible in UI)
url	URL		URL of the schema	true
queues	list[URL]		List of queues that use schema object.	true
content	list[object]		List of sections (top-level schema objects, see Document Schema for description of schema)
metadata	object	{}	Client data, see metadata.

List all schemas

List all schemas

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/schemas'

{
  "pagination": {
    "total": 2,
    "total_pages": 1,
    "next": null,
    "previous": null
  },
  "results": [
    {
      "id": 31336,
      "url": "https://api.elis.rossum.ai/v1/schemas/31336"
    },
    {
      "id": 33725,
      "url": "https://api.elis.rossum.ai/v1/schemas/33725"
    }
  ]
}

GET /v1/schemas

Retrieve all schema objects.

Supported filters: schemas cannot be filtered

Supported ordering: id

Response

Status: 200

Returns paginated response with a list of schema objects.

Create a new schema

Create new empty schema

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"name": "Test Schema", "content": []}' \
  'https://api.elis.rossum.ai/v1/schemas'

{
  "id": 33725,
  "name": "Test Schema",
  "queues": [],
  "url": "https://api.elis.rossum.ai/v1/schemas/33725",
  "content": [],
  "metadata": {}
}

POST /v1/schemas

Create a new schema object.

Response

Status: 201

Returns created schema object.

Retrieve a schema

Get schema object 31336

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/schemas/31336'

{
  "id": 31336,
  "name": "Basic schema",
  "queues": [
    "https://api.elis.rossum.ai/v1/queues/8236"
  ],
  "url": "https://api.elis.rossum.ai/v1/schemas/31336",
  "content": [
    {
      "category": "section",
      "id": "invoice_details_section",
      "label": "Invoice details",
      "children": [
        {
          "category": "datapoint",
          "id": "invoice_id",
          "label": "Invoice number",
          "type": "string",
          "width_chars": 10,
          "rir_field_names": [
            "invoice_id"
          ],
          "constraints": {
            "required": false
          },
          "default_value": null
        },
        ...
      ]
    },
    ...
  ]
}

GET /v1/schemas/{id}

Get an schema object.

Response

Status: 200

Returns schema object.

Update a schema

Update content of schema object 33725

curl -X PUT -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"name":"Test Schema","content":[{"category":"section","id":"invoice_details_section","label":"Invoice details","icon": null,"children":[{"category":"datapoint","id":"invoice_id","label":"Invoice number","type":"string","width_chars":10,"rir_field_names":["invoice_id"]}]}]}' \
  'https://api.elis.rossum.ai/v1/schemas/33725'

{
  "id": 33725,
  "name": "Test Schema",
  "queues": [],
  "url": "https://api.elis.rossum.ai/v1/schemas/33725",
  "content": [
    {
      "category": "section",
      "id": "invoice_details_section",
      "label": "Invoice details",
      "children": [
        {
          "category": "datapoint",
          "id": "invoice_id",
          "label": "Invoice number",
          "type": "string",
          "width_chars": 10,
          "rir_field_names": [
            "invoice_id"
          ],
          "default_value": null
        }
      ],
      "icon": null
    }
  ],
  "metadata": {}
}

PUT /v1/schemas/{id}

Update schema object. See Updating schema for more details about consequences of schema update.

Response

Status: 200

Returns updated schema object.

Update part of a schema

Update schema object 31336

curl -X PATCH -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"content": []}' \
  'https://api.elis.rossum.ai/v1/schemas/31336'

{
  "id": 31336,
  "name": "Test Schema",
  "queues": [
    "https://api.elis.rossum.ai/v1/queues/8236"
  ],
  "url": "https://api.elis.rossum.ai/v1/schemas/31336",
  "content": [],
  "metadata": {}
}

PATCH /v1/schemas/{id}

Update part of schema object. See Updating schema for more details about consequences of schema update.

Response

Status: 200

Returns updated schema object.

Delete a schema

Delete schema 31336

curl -X DELETE -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/schemas/31336'

DELETE /v1/schemas/{id}

Delete schema object.

Response

Status: 204

Document

Example document object

{
  "id": 314628,
  "url": "https://api.elis.rossum.ai/v1/documents/314628",
  "s3_name": "272c2f01ae84a4e19a421cb432e490bb",
  "annotations": [
    "https://api.elis.rossum.ai/v1/annotations/314528"
  ],
  "mime_type": "application/pdf",
  "arrived_at": "2019-02-06T23:04:00.933658Z",
  "original_file_name": "test_invoice_1.pdf",
  "content": "https://api.elis.rossum.ai/v1/documents/314628/content",
  "metadata": {}
}

A document object contains information about one input file (PDF or image). It cannot be created through the API, you need to use queue upload endpoint.

Attribute	Type	Default	Description	Read-only
id	integer		Id of the document	true
url	URL		URL of the document	true
s3_name	string		Internal	true
annotations	list[URL]		List of annotations related to the document. Usually there is only one annotation.
mime_type	string		MIME type of the document (e.g. application/pdf)	true
arrived_at	datetime		Timestamp of document upload or incoming email attachment extraction.	true
original_file_name	string		File name of the attachment or upload.	true
content	URL		Link to the document raw content (e.g. PDF file)
metadata	object	{}	Client data, see metadata.

List all documents

List all documents

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/documents'

{
  "pagination": {
    "total": 2,
    "total_pages": 1,
    "next": null,
    "previous": null
  },
  "results": [
    {
      "id": 314628,
      "url": "https://api.elis.rossum.ai/v1/documents/314628",
      "s3_name": "272c2f01ae84a4e19a421cb432e490bb",
      "annotations": [
        "https://api.elis.rossum.ai/v1/annotations/314528"
      ],
      "mime_type": "application/pdf",
      "arrived_at": "2019-02-06T23:04:00.933658Z",
      "original_file_name": "test_invoice_1.pdf",
      "content": "https://api.elis.rossum.ai/v1/documents/314628/content",
      "metadata": {}
    },
    {
      "id": 315609,
      "url": "https://api.elis.rossum.ai/v1/documents/315609",
      "s3_name": "8e506763caa2bc03f09cba3bf4817f84",
      "annotations": [
        "https://api.elis.rossum.ai/v1/annotations/315509"
      ],
      "mime_type": "image/png",
      "arrived_at": "2019-02-07T16:16:30.726217Z",
      "original_file_name": "test_invoice_2.png",
      "content": "https://api.elis.rossum.ai/v1/documents/315609/content",
      "metadata": {}
    }
  ]
}

GET /v1/documents

Retrieve all document objects.

Supported filters: arrived_at, original_file_name

Supported ordering: id, arrived_at, original_file_name, s3_name, mime_type

Response

Status: 200

Returns paginated response with a list of document objects.

Retrieve a document

Get document object 314628

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/documents/314628'

{
  "id": 314628,
  "url": "https://api.elis.rossum.ai/v1/documents/314628",
  "s3_name": "272c2f01ae84a4e19a421cb432e490bb",
  "annotations": [
    "https://api.elis.rossum.ai/v1/annotations/314528"
  ],
  "mime_type": "application/pdf",
  "arrived_at": "2019-02-06T23:04:00.933658Z",
  "original_file_name": "test_invoice_1.pdf",
  "content": "https://api.elis.rossum.ai/v1/documents/314628/content",
  "metadata": {}
}

GET /v1/documents/{id}

Get a document object.

Response

Status: 200

Returns document object.

Permanent URL

Download document original from a permanent URL

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/original/272c2f01ae84a4e19a421cb432e490bb'

GET /v1/original/272c2f01ae84a4e19a421cb432e490bb

Get original document content (e.g. PDF file).

Response

Status: 200

Returns original document file.

Delete a document

Delete document 314628

curl -X DELETE -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/documents/314628'

DELETE /v1/documents/{id}

Delete document object.

Response

Status: 204

Annotation

Example annotation object

{
  "document": "https://api.elis.rossum.ai/v1/documents/314628",
  "id": 314528,
  "queue": "https://api.elis.rossum.ai/v1/queues/8199",
  "schema": "https://api.elis.rossum.ai/v1/schemas/95",
  "pages": [
    "https://api.elis.rossum.ai/v1/pages/558598"
  ],
  "modifier": null,
  "modified_at": null,
  "confirmed_at": null,
  "exported_at": null,
  "assigned_at": null,
  "status": "to_review",
  "rir_poll_id": "54f6b9ecfa751789f71ddf12",
  "messages": null,
  "url": "https://api.elis.rossum.ai/v1/annotations/314528",
  "content": "https://api.elis.rossum.ai/v1/annotations/314528/content",
  "time_spent": 0,
  "metadata": {}
}

An annotation object contains all extracted and verified data related to a document. Every document belongs to a queue and is related to the schema object, that defines datapoint types and overall shape of the extracted data.

It cannot be created through the API, you need to use queue upload endpoint.

Attribute	Type	Default	Description	Read-only
id	integer		Id of the annotation	true
url	URL		URL of the annotation	true
status	enum		Status of the document, see Document Lifecycle for list of value.
document	URL		Related document.
queue	URL		Queues that annotation belongs to.
schema	URL		Schema that defines content shape.	true
pages	list[URL]		List of rendered pages.	true
modifier	URL		User that last modified the annotation.
assigned_at	datetime		Timestamp of last assignment to a user.	true
modified_at	datetime		Timestamp of last modification.	true
confirmed_at	datetime		Timestamp of confirmation by the user.	true
exported_at	datetime		Timestamp of finished export.	true
rir_poll_id	string		Internal.
messages	list[object]	[]	List of messages from the connector.
content	URL		Link to annotation data (datapoint values), see Annotation data.	true
time_spent	float	0	Total time spent while validating the annotation.
metadata	object	{}	Client data, see metadata.

Start annotation

Start annotation of object 319668

curl -X POST -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/annotations/319668/start'

{
  "annotation": "https://api.elis.rossum.ai/v1/annotations/319668",
  "session_timeout": "01:00:00"
}

POST /v1/annotations/{id}/start

Assign the calling user the annotation.

Response

Status: 200

Returns object with annotation and session_timeout keys.

Start embedded annotation

Start embedded annotation of object 319668

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"return_url": "https://service.com/return", "cancel_url": "https://service.com/cancel"}' \
  'https://api.elis.rossum.ai/v1/annotations/319668/start_embedded'

{
  "url": "https://embedded.elis.rossum.ai/document/319668#authToken=1c50ae8552441a2cda3c360c1e8cb6f2d91b14a9"
}

POST /v1/annotations/{id}/start_embedded

Start embedded annotation. It requires two parameters: return_url and cancel_url.

Key	Description
return_url	URL browser is redirected to in case of successful user validation (max. length: 256 chars)
cancel_url	URL browser is redirected to in case of user canceling the validation (max. length: 256 chars)

Response

Status: 200

Returns object with url that specifies URL to be used in the browser iframe/popup window. URL includes a token that is valid for this document only for a limited period of time (queue's session_timeout).

Confirm annotation

Confirm annotation of object 319668

curl -X POST -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/annotations/319668/confirm'

POST /v1/annotations/{id}/confirm

Confirm annotation, switch status to exporting.

Response

Status: 204

Cancel annotation

Cancel annotation of object 319668

curl -X POST -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/annotations/319668/cancel'

POST /v1/annotations/{id}/cancel

Cancel annotation, switch statue to the previous one: to_review or postponed.

Response

Status: 204

Switch to postponed

Postpone annotation status of object 319668 to postponed

curl -X POST -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/annotations/319668/postpone'

POST /v1/annotations/{id}/postpone

Switch annotation status to postpone.

Response

Status: 204

Switch to deleted

Switch annotation status of object 319668 to deleted

curl -X POST -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/annotations/319668/delete'

POST /v1/annotations/{id}/delete

Switch annotation status to deleted. Annotation with status deleted is still available in Elis UI.

Response

Status: 204

Search for text

Search for text in annotation 319668

curl -X POST -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/annotations/319668/search?phrase=some'

{
  "results": [
    {
      "rectangle": [
        67.15157010915198,
        545.9286363906203,
        87.99106633081445,
        563.4617583852776
      ],
      "page": 1
    },
    {
      "rectangle": [
        45.27717884130982,
        1060.3084761056693,
        66.11667506297229,
        1077.8415981003266
      ],
      "page": 1
    }
  ],
  "status": "ok"
}

POST /v1/annotations/{id}/search

Search for a phrase in the document.

Argument	Description
phrase	A phrase to search for
tolerance	Allowed Edit distance from the search phrase. Only used for OCR invoices (images, such as png or PDF with scanned images).

Response

Status: 200

Returns results with a list of objects:

Key	Type	Description
rectangle	list[float]	Bounding box of an occurrence.
page	integer	Page of occurrence.

List all annotations

List all annotations

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/annotations'

{
  "pagination": {
    "total": 22,
    "total_pages": 1,
    "next": null,
    "previous": null
  },
  "results": [
    {
      "document": "https://api.elis.rossum.ai/v1/documents/315877",
      "id": 315777,
      "queue": "https://api.elis.rossum.ai/v1/queues/8236",
      "schema": "https://api.elis.rossum.ai/v1/schemas/31336",
      "pages": [
        "https://api.elis.rossum.ai/v1/pages/561206"
      ],
      "modifier": null,
      "modified_at": null,
      "confirmed_at": null,
      "exported_at": null,
      "assigned_at": null,
      "status": "to_review",
      "rir_poll_id": "54f6b9ecfa751789f71ddf12",
      "messages": null,
      "url": "https://api.elis.rossum.ai/v1/annotations/315777",
      "content": "https://api.elis.rossum.ai/v1/annotations/315777/content",
      "time_spent": 0,
      "metadata": {}
    },
    {
      ...
    }
  ]
}

GET /v1/annotations

Retrieve all annotation objects.

Supported ordering: document, document__arived_at, document__original_file_name, modifier, modifier__username, queue, status, assigned_at, confirmed_at, modified_at, exported_at

Filters

Filters may be specified to limit annotations to be listed.

Attribute	Description
status	Annotation status, multiple values may be separated using a comma
id	List of ids separated by a comma
modifier	User id
document	Document id
queue	Queue id
arrived_at_before	ISO 8601 timestamp (e.g. arrived_at_before=2019-11-05)
arrived_at_after	ISO 8601 timestamp (e.g. arrived_at_after=2019-11-04)
assigned_at_before	ISO 8601 timestamp (e.g. assigned_at_before=2019-11-05)
assigned_at_after	ISO 8601 timestamp (e.g. assigned_at_after=2019-11-04)
confirmed_at_before	ISO 8601 timestamp (e.g. confirmed_at_before=2019-11-05)
confirmed_at_after	ISO 8601 timestamp (e.g. confirmed_at_after=2019-11-04)
modified_at_before	ISO 8601 timestamp (e.g. modified_at_before=2019-11-05)
modified_at_after	ISO 8601 timestamp (e.g. modified_at_after=2019-11-04)
exported_at_before	ISO 8601 timestamp (e.g. exported_at_before=2019-11-04 22:00:00)
exported_at_after	ISO 8601 timestamp (e.g. exported_at_after=2019-11-04 12:00:00)

Query fields

Obtain only subset of annotation attributes

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/annotations?fields=id,url'

{
  "pagination": {
    "total": 22,
    "total_pages": 1,
    "next": null,
    "previous": null
  },
  "results": [
    {
      "id": 320332,
      "url": "https://api.elis.rossum.ai/v1/annotations/320332"
    },
    {
      "id": 319668,
      "url": "https://api.elis.rossum.ai/v1/annotations/319668"
    },
    ...
  ]
}

In order to obtain only subset of annotation object attributes, one can use query parameter fields.

Argument	Description
fields	Comma-separated list of attributes to be included in the response.
fields!	Comma-separated list of attributes to be excluded from the response.

Sideloading

Sideload documents and modifiers

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/annotations?sideload=modifiers,documents'

{
  "pagination": {
    "total": 22,
    "total_pages": 1,
    "next": null,
    "previous": null
  },
  "results": [
    {
      "document": "https://api.elis.rossum.ai/v1/documents/320432",
      "id": 320332,
      ...,
      "modifier": "https://api.elis.rossum.ai/v1/users/10775",
      "status": "to_review",
      "rir_poll_id": "a898b6bdc8964721b38e0160",
      "messages": null,
      "url": "https://api.elis.rossum.ai/v1/annotations/320332",
      "content": "https://api.elis.rossum.ai/v1/annotations/320332/content",
      "time_spent": 0,
      "metadata": {}
    },
    ...
  ],
  "documents": [
    {
      "id": 320432,
      "url": "https://api.elis.rossum.ai/v1/documents/320432",
      ...
    },
    ...
  ],
  "modifiers": [
    {
      "id": 10775,
      "url": "https://api.elis.rossum.ai/v1/users/10775",
      ...
    },
    ...
  ]
}

In order to decrease the number of requests necessary for obtaining useful information about annotations, modifiers and documents can be sideloaded using query parameter sideload. This parameter accepts comma-separated list of keywords: modifiers, documents. Then the response is enriched by the requested keys, which contain lists of the sideloaded objects.

Response

Status: 200

Returns paginated response with a list of annotation objects.

Retrieve an annotation

Get annotation object 315777

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/annotations/315777'

{
  "document": "https://api.elis.rossum.ai/v1/documents/315877",
  "id": 315777,
  "queue": "https://api.elis.rossum.ai/v1/queues/8236",
  "schema": "https://api.elis.rossum.ai/v1/schemas/31336",
  "pages": [
    "https://api.elis.rossum.ai/v1/pages/561206"
  ],
  "modifier": null,
  "modified_at": null,
  "confirmed_at": null,
  "exported_at": null,
  "assigned_at": null,
  "status": "to_review",
  "rir_poll_id": "54f6b9ecfa751789f71ddf12",
  "messages": null,
  "url": "https://api.elis.rossum.ai/v1/annotations/315777",
  "content": "https://api.elis.rossum.ai/v1/annotations/315777/content",
  "time_spent": 0,
  "metadata": {}
}

GET /v1/annotations/{id}

Get an annotation object.

Response

Status: 200

Returns annotation object.

Update an annotation

Update annotation object 315777

curl -X PUT -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"document": "https://api.elis.rossum.ai/v1/documents/315877", "queue": "https://api.elis.rossum.ai/v1/queues/8236", "status": "postponed"}' \
  'https://api.elis.rossum.ai/v1/annotations/315777'

{
  "document": "https://api.elis.rossum.ai/v1/documents/315877",
  "id": 315777,
  "queue": "https://api.elis.rossum.ai/v1/queues/8236",
  ...
  "status": "postponed",
  "rir_poll_id": "a898b6bdc8964721b38e0160",
  "messages": null,
  "url": "https://api.elis.rossum.ai/v1/annotations/315777",
  "content": "https://api.elis.rossum.ai/v1/annotations/315777/content",
  "time_spent": 0,
  "metadata": {}
}

PUT /v1/annotations/{id}

Update annotation object.

Response

Status: 200

Returns updated annotation object.

Update part of an annotation

Update status of annotation object 315777

curl -X PATCH -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"status": "deleted"}' \
  'https://api.elis.rossum.ai/v1/annotations/315777'

{
  "document": "https://api.elis.rossum.ai/v1/documents/315877",
  "id": 315777,
  ...
  "status": "deleted",
  "rir_poll_id": "a898b6bdc8964721b38e0160",
  "messages": null,
  "url": "https://api.elis.rossum.ai/v1/annotations/315777",
  "content": "https://api.elis.rossum.ai/v1/annotations/315777/content",
  "time_spent": 0,
  "metadata": {}
}

PATCH /v1/annotations/{id}

Update part of annotation object.

Response

Status: 200

Returns updated annotation object.

Copy annotation

Copy annotation 315777 to a queue 8236

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' -H 'Content-Type: application/json' \
  -d '{"target_queue": "https://api.elis.rossum.ai/v1/queues/8236", "target_status": "to_review"}' \
  'https://api.elis.rossum.ai/v1/annotations/315777/copy'

{
  "annotation": "https://api.elis.rossum.ai/v1/annotations/320332"
}

POST /v1/annotations/{id}/copy

Make a copy of annotation in another queue. All data and metadata are copied.

Key	Description
target_queue	URL of queue, where the copy should be placed.
target_status	Status of copied annotation (if not set, it stays the same)

Response

Status: 200

Returns URL of the new annotation object.

Delete annotation

Delete annotation 315777

curl -X DELETE -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/annotations/315777'

DELETE /v1/annotations/{id}

Delete an annotation object. Deleted annotation is purged from the database and is not available any more. You may consider to mark the annotation as deleted instead.

Response

Status: 204

Annotation Data

Example annotation data

{
  "content": [
    {
      "id": 27801931,
      "url": "https://api.elis.rossum.ai/v1/annotations/319668/content/27801931",
      "children": [
        {
          "id": 27801932,
          "url": "https://api.elis.rossum.ai/v1/annotations/319668/content/27801932",
          "content": {
            "value": "2183760194",
            "page": 1,
            "position": [
              761,
              48,
              925,
              84
            ],
            "rir_text": "2183760194",
            "connector_text": null
          },
          "category": "datapoint",
          "schema_id": "invoice_id",
          "validation_sources": [
            "score"
          ],
          "time_spent": 0,
          "hidden": false
        },
        {
          "id": 27801933,
          "url": "https://api.elis.rossum.ai/v1/annotations/319668/content/27801933",
          "content": {
            "value": "6/8/2018",
            "page": 1,
            "position": [
              283,
              300,
              375,
              324
            ],
            "rir_text": "6/8/2018",
            "connector_text": null
          },
          "category": "datapoint",
          "schema_id": "date_issue",
          "validation_sources": [
            "score"
          ],
          "time_spent": 0,
          "hidden": false
        },
        ...
    }
  ]
}

Annotation data is used by the Elis UI to display annotation data properly. Be aware that values are not normalized (e.g. numbers, dates) and data structure may be changed to accommodate UI requirements.

Get annotation data

Get annotation data of annotation 315777

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/annotations/315777/content'

GET /v1/annotations/{id}/content

Get annotation data.

Response

Status: 200

Returns annotation data.

Page

Example page object

{
  "id": 558598,
  "annotation": "https://api.elis.rossum.ai/v1/annotations/314528",
  "number": 1,
  "rotation_deg": 0,
  "mime_type": "image/png",
  "s3_name": "4b66305775c029cb0cfa80fd0ebb2da6",
  "url": "https://api.elis.rossum.ai/v1/pages/558598",
  "content": "https://api.elis.rossum.ai/v1/pages/558598/content",
  "metadata": {}
}

A page object contains information about one page of the annotation (we render pages separately for every annotation, but this will change in the future).

Page objects are created automatically during document import and cannot be created through the API, you need to use queue upload endpoint. Pages cannot be deleted directly -- they are deleted on parent annotation delete.

Attribute	Type	Default	Description	Read-only
id	integer		Id of the page	true
url	URL		URL of the page.	true
annotation	URL		Annotation that page belongs to.
number	integer		Page index, first page has index 1.
rotation_deg	integer		Page rotation, currently unused.
mime_type	string		MIME type of the page (image/png).	true
s3_name	string		Internal	true
content	URL		Link to the page raw content (pdf file).
metadata	object	{}	Client data, see metadata.

List all pages

List all pages

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/pages'

{
  "pagination": {
    "total": 1,
    "total_pages": 1,
    "next": null,
    "previous": null
  },
  "results": [
    {
      "id": 558598,
      "annotation": "https://api.elis.rossum.ai/v1/annotations/314528",
      "number": 1,
      "rotation_deg": 0,
      "mime_type": "image/png",
      "s3_name": "7eb0dcc0faa8868b55fb425d21cc60dd",
      "url": "https://api.elis.rossum.ai/v1/pages/558598",
      "content": "https://api.elis.rossum.ai/v1/pages/558598/content",
      "metadata": {}
    }
  ]
}

GET /v1/pages

Retrieve all page objects.

Supported filters: annotation, number

Supported ordering: id, number, s3_name

Response

Status: 200

Returns paginated response with a list of page objects.

Retrieve a page

Get page object 558598

curl -H 'Authorization: token db313f24f5738c8e04635e036ec8a45cdd6d6b03' \
  'https://api.elis.rossum.ai/v1/pages/558598'

{
  "id": 558598,
  "annotation": "https://api.elis.rossum.ai/v1/annotations/314528",
  "number": 1,
  "rotation_deg": 0,
  "mime_type": "image/png",
  "s3_name": "7eb0dcc0faa8868b55fb425d21cc60dd",
  "url": "https://api.elis.rossum.ai/v1/pages/558598",
  "content": "https://api.elis.rossum.ai/v1/pages/558598/content",
  "metadata": {}
}

GET /v1/pages/{id}

Get an page object.

Response

Status: 200

Returns page object.

FAQ

POST fails with HTTP status 500

Please check that Content-Type header in the HTTP request is set correctly (e.g. application/json).

We will improve content type checking in the future , so that to return 400.

SSL connection errors

Elis API only supports TLS 1.2 to ensure [up-to-date algorithms and ciphers](level of security](https://security.googleblog.com/2018/10/modernizing-transport-security.html) are used.

Older SSL libraries may not work properly with TLS 1.2. If you encounter SSL/TLS compatibility issue, please make sure the library supports TLS 1.2 and the support is switched on.