API Docs

List sales invoice UUIDs

Retrieves a paginated list of sales invoice UUIDs. See the right panel for the request and response examples.

Rate limit

60 requests/minute per authenticated account. See Rate limiting for response headers (X-RateLimit-*) and retry guidance.

Query parameters

Parameter	Type	Required	Description
`created_on`	string	Required	Filter UUIDs by creation date. Format: `yyyy-MM-dd`.
`page`	integer	Optional	Page number (0-indexed). Default: 0.
`size`	integer	Optional	Number of UUIDs per page. Default: 10.

Response

Status code: 200 OK

Pagination fields

Field	Type	Source	Description
`content`	array	System Provided	Array of sales invoice UUID strings.
`page_number`	integer	System Provided	Current page (0-indexed).
`total_pages`	integer	System Provided	Total pages.
`total_elements`	integer	System Provided	Total matching UUIDs for the requested `created_on` date.

Response item fields

Each item in content is a UUID string. Use Retrieve a sales invoice to fetch the full document for a given UUID.

Error responses

Status	Description
400 Bad Request	Invalid request parameters or validation failed. For validation errors, the response includes field-specific errors.
401 Unauthorized	Authentication required or invalid token.
500 Internal Server Error	An error occurred while processing the request.

Request

# Base URL: https://api-sandbox.ae.marmin.ai
# GET /api/sales-invoices/uuids

curl "https://api-sandbox.ae.marmin.ai/api/sales-invoices/uuids?created_on=2026-04-17&page=0&size=10" \
  -H "Authorization: Bearer <access_token>"

Response

{
  "content": [
    "a6e92c79-7334-4192-97ff-2da77628f324",
    "c0622c00-ddc2-4b2a-8a89-0fe5f57a41ce",
    "c1f22ff2-e19b-4fad-bbf3-5d92421ff294",
    "55c56afc-e57f-4ac3-b0b5-986324a9726f",
    "e179d6fb-20d4-4aa3-a551-c27a4d6ddf62"
  ],
  "page_number": 0,
  "total_pages": 2,
  "total_elements": 15
}