Get a list of documents | Invofox

Authentication

x-api-keystring

API Key authentication via header

Query parameters

filterstringOptional

Query filter in JSON format. Supports filtering by document properties with operators.

Filter by company:

1 {"company": {"eq": "507f1f77bcf86cd799439011"}}

Filter by public state (single value):

1 {"publicState": {"in": ["approved"]}}

Filter by multiple states:

1 {"publicState": {"in": ["approved", "exported"]}}

Filter by document type:

1 {"type": {"in": ["6827663ca0609723f538dea6", "6827663ca0609723f538deca"]}}

Filter by page count:

1 {"pageCount": {"eq": 11}}

Filter by date range:

1 {"creation": {"gte": "2024-01-01T00:00:00.000Z", "lte": "2024-12-31T23:59:59.999Z"}}

Filter by data fields:

1 {"data.totalAmount": {"gte": 1000}}

Combine multiple filters:

1 {
2   "type": {"in": ["6827663ca0609723f538dea6"]},
3   "publicState": {"in": ["approved"]},
4   "pageCount": {"eq": 11}
5 }

Filter by client data:

1 {"clientData.externalId": {"eq": "ORDER-123"}}

Available operators:

eq - Equals
ne - Not equals
gt - Greater than
gte - Greater than or equal
lt - Less than
lte - Less than or equal
in - Value in array

Query filter in JSON format. Supports filtering by document properties with operators. **Filter by company:** ```json {"company": {"eq": "507f1f77bcf86cd799439011"}} ``` **Filter by public state (single value):** ```json {"publicState": {"in": ["approved"]}} ``` **Filter by multiple states:** ```json {"publicState": {"in": ["approved", "exported"]}} ``` **Filter by document type:** ```json {"type": {"in": ["6827663ca0609723f538dea6", "6827663ca0609723f538deca"]}} ``` **Filter by page count:** ```json {"pageCount": {"eq": 11}} ``` **Filter by date range:** ```json {"creation": {"gte": "2024-01-01T00:00:00.000Z", "lte": "2024-12-31T23:59:59.999Z"}} ``` **Filter by data fields:** ```json {"data.totalAmount": {"gte": 1000}} ``` **Combine multiple filters:** ```json { "type": {"in": ["6827663ca0609723f538dea6"]}, "publicState": {"in": ["approved"]}, "pageCount": {"eq": 11} } ``` **Filter by client data:** ```json {"clientData.externalId": {"eq": "ORDER-123"}} ``` **Available operators:** - `eq` - Equals - `ne` - Not equals - `gt` - Greater than - `gte` - Greater than or equal - `lt` - Less than - `lte` - Less than or equal - `in` - Value in array

sortstringOptional

Field to sort documents by. Prefix with - for descending order (e.g., -creation for newest first).

selectlist of stringsOptional

Comma-separated fields to include in the response. You can specify any field path using dot notation.

Common fields: _id, company, publicState, type, data, data.invoiceNumber, clientData, creation, confidence, pageCount

Examples:

To get basic info: _id,publicState,type
To get specific data fields: _id,data.invoiceNumber,data.totalAmount
To get all data: data,type,company,confidence,publicState,creation

Comma-separated fields to include in the response. You can specify any field path using dot notation. **Common fields:** `_id`, `company`, `publicState`, `type`, `data`, `data.invoiceNumber`, `clientData`, `creation`, `confidence`, `pageCount` **Examples:** - To get basic info: `_id,publicState,type` - To get specific data fields: `_id,data.invoiceNumber,data.totalAmount` - To get all data: `data,type,company,confidence,publicState,creation`

skipdoubleOptionalDefaults to 0

(List pagination element) number of documents to skip of the list .The list is made up of documents that comply with the terms have been defined in the query.The skips start from the top of the list.

limitdoubleOptional<=500Defaults to 50

(List pagination element) total number of documents to retrieve (max. 500) of the list.The retrieval starts from the established position by the value of the param skip.

Response

List of documents

skipdouble or null

limitdouble or null

countdouble or null

resultlist of objects or null

Errors