List documents

Besides querying a single document by its identifier (see Check status), the API exposes a paginated listing with filters — ideal for reconciling your database against Ocote without going document by document.

`GET /documents`

Lists sales documents (Invoice, CCF, Credit Note, Export) issued by the company.

Technical details


Method	`GET`
URL	`https://ocote.io/api/connect/documents`
Authentication	Header `Authorization: Bearer odt_...`

Filters (query params)

All optional; they combine with each other.

Parameter	Description
`doc_type`	Filter by type: `01`, `03`, `05`, `11`.
`success`	`true` / `false`.
`invalidated`	`true` / `false`.
`date_from` / `date_to`	Range by issue date (`YYYY-MM-DD`).
`customer_name`	Partial match on the customer name.
`control_number`	Partial match on the control number.
`external_ref`	Exact match.
`page`	Page number (default `1`).
`per_page`	Page size (default `50`, maximum `100`).

Response

{
  "results": [ /* ... documents ... */ ],
  "total": 128,
  "page": 1,
  "per_page": 50,
  "total_pages": 3
}

Example

curl
curl -H "Authorization: Bearer odt_xxx" \
  "https://ocote.io/api/connect/documents?doc_type=03&date_from=2026-06-01&date_to=2026-06-30&page=1"

Other endpoints in the family

Endpoint	Purpose
`GET /documents/{id_or_ref}`	Detail of a sale (by UUID or `external_ref`).
`GET /documents/suex`	List of Excluded Subjects.
`GET /documents/suex/{id_or_ref}`	Detail of an Excluded Subject.
`GET /documents/summary`	Aggregated totals (counts and amounts per document type), with `date_from` / `date_to` filters.

GET /documents​

Technical details​

Filters (query params)​

Response​

Example​

Other endpoints in the family​

See also​