List orders

Returns the paginated list of your integration's orders, newest first.

Request

ENDPOINT

/v1/insurance/order

METHOD

GET

Query params

Parameter	Type	Required	Description
page	integer	optional	Page number. Default: 1.
page_size	integer	optional	Records per page. Default: 50. Maximum: 200.
status	string	optional	Filters by order status (e.g. awaiting_payment).
customer_document_number	string	optional	Filters by the insured person's document.
request_control_key	string	optional	Filters by your idempotency key.
distribution_type	string	optional	Filters by the distribution model (e.g. direct).
created_from	string	optional	Minimum creation date/time (ISO 8601).
created_to	string	optional	Maximum creation date/time (ISO 8601).

Example call

GET /v1/insurance/order?page=1&page_size=50&status=awaiting_payment&created_from=2026-07-01T00:00:00Z

Response

STATUS

200

Response Body

{
  "items": [
    {
      "order_key": "5e2b3f60-7c4b-4c8e-9f1a-6d2e8b4a7c90",
      "status": "awaiting_payment",
      "product_keys": ["9d1f8c7a-3b21-4e60-8a2f-1c5d7e9b0a44"],
      "customer_document_number": "96969879003",
      "total_order_amount": 617.28,
      "created_at": "2026-07-14T12:00:00Z"
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 137
}

Response attributes

Field	Type	Description
items	array	List of order summaries.
page	integer	Current page.
page_size	integer	Requested page size.
total	integer	Total number of orders matching the filters.

Object in items

Field	Type	Description
order_key	string	Unique order key.
status	string	Current status. See the lifecycle.
product_keys	array	Keys of the products sold in the order.
customer_document_number	string	Insured person's document.
total_order_amount	number	Total order amount (sum of the products' gross premiums).
created_at	string	Submission date/time.

Possible errors

Every error (non-2xx) returns the standard body { "title", "description", "translation", "code" } — programmatically handle only the code field.

Status	Code	Description
400	QIT000010	Invalid pagination parameter.
400	QIT000001	Malformed filter parameter.
401 / 403	—	Authentication or authorization failure.
429	—	Rate limit exceeded — retry with backoff.
500 / 503	QIT000500	Internal error or service unavailable — safe to retry.