API Docs

List proforma invoice UUIDs

Retrieves a paginated list of proforma 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.

Response

Status code: 200 OK

Returns a paginated response containing an array of proforma invoice UUID strings.

See the right panel for complete response examples.

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/proforma-invoices/uuids

curl "https://api-sandbox.ae.marmin.ai/api/proforma-invoices/uuids?created_on=2026-04-17&page=0" \
  -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": 1,
  "total_pages": 2,
  "total_elements": 15
}