List all orders

GET https://pos.paysera.com/epapi/v1/orders

Retrieve a paginated list of orders with optional filtering.

Filtering Options

• Date range (creation and update dates)
• Order status
• Order numbers

Pagination

Use page and pageSize parameters to navigate through results.

Authorization

This endpoint requires MAC (Message Authentication Code) authentication.

Authorization Header Format:

Authorization: MAC id="CLIENT_ID", ts="TIMESTAMP", nonce="RANDOM_STRING", mac="MAC_HASH", ext="body_hash=BODY_HASH"

Example:

Authorization: MAC id="a9b8c7d6e5f4g3h2", ts="1234567890", nonce="xyz123abc456def", mac="dGhpcyBpcyBhIHJhbmRvbSBtYWMgaGFzaCB2YWx1ZQ==", ext="body_hash=cmFuZG9tQm9keUhhc2hWYWx1ZQ%3D%3D"

For more details, see the Authentication section.

Parameters

Query Parameters

Name	Type	Required	Description
pageSize	integer		Number of items per page (1-100)
page	integer		Page number (≥1)
createdAtFrom	string		Filter orders created from this date
createdAtTo	string		Filter orders created until this date
updatedAtFrom	string		Filter orders updated from this date
updatedAtTo	string		Filter orders updated until this date
status	array		Filter by order status(es)
numbers	array		Filter by specific order numbers

Example

Request

GET https://pos.paysera.com/epapi/v1/orders?pageSize=20&page=1&createdAtFrom=2024-01-01T00:00:00Z&createdAtTo=2024-12-31T23:59:59Z&updatedAtFrom=2024-01-01T00:00:00Z&updatedAtTo=2024-12-31T23:59:59Z&status=pending,confirmed&numbers=ORD001,ORD002
Authorization: MAC id="CLIENT_ID", ts="TIMESTAMP", nonce="RANDOM_STRING", mac="MAC_HASH"

Response

{
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "number": "ORD-2024-158",
      "currency": "EUR",
      "status": "confirmed",
      "totalPrice": 5499,
      "createdAt": "2024-11-04T10:15:30Z",
      "updatedAt": "2024-11-04T10:20:45Z"
    },
    {
      "id": "987f6543-e21c-43d2-b789-123456789abc",
      "number": "ORD-2024-159",
      "currency": "EUR",
      "status": "pending",
      "totalPrice": 1999,
      "createdAt": "2024-11-04T11:30:00Z",
      "updatedAt": "2024-11-04T11:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalItems": 2,
    "totalPages": 1
  }
}

AUTHORIZATION: HTTP

REQUEST

Base URL

https://pos.paysera.com

Query Parameters

pageSize

Number of items per page (1-100)

page

Page number (≥1)

createdAtFrom

Filter orders created from this date

createdAtTo

Filter orders created until this date

updatedAtFrom

Filter orders updated from this date

updatedAtTo

Filter orders updated until this date

status

Filter by order status(es)

numbers

Filter by specific order numbers

RESPONSE

Orders retrieved successfully

{
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "number": "ORD-2024-158",
      "currency": "EUR",
      "status": "confirmed",
      "totalPrice": 5499,
      "createdAt": "2024-11-04T10:15:30Z",
      "updatedAt": "2024-11-04T10:20:45Z"
    },
    {
      "id": "987f6543-e21c-43d2-b789-123456789abc",
      "number": "ORD-2024-159",
      "currency": "EUR",
      "status": "pending",
      "totalPrice": 1999,
      "createdAt": "2024-11-04T11:30:00Z",
      "updatedAt": "2024-11-04T11:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalItems": 2,
    "totalPages": 1
  }
}