List financial documents

GET https://pos.paysera.com/epapi/v1/cash-registers/{number}/financial-documents

Retrieve a paginated list of financial documents for a specific cash register.

Financial documents include receipts, returns, collections, and fiscal day reports.

Filtering

You can filter documents by:

• Creation date range
• Document type
• Fiscal day number

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

Path Parameters

Name	Type	Required	Description
number	string	✓	Cash register identifier/number

Query Parameters

Name	Type	Required	Description
pageSize	integer		Number of items per page (1-100)
page	integer		Page number (≥1)
createdAtFrom	string		Filter documents created from this date (ISO 8601 format)
createdAtTo	string		Filter documents created until this date (ISO 8601 format)
type	array		Filter by document type(s)
fiscalDayNumber	integer		Filter by fiscal day number

Example

Request

GET https://pos.paysera.com/epapi/v1/cash-registers/{number}/financial-documents?pageSize=20&page=1&createdAtFrom=2024-01-01T00:00:00Z&createdAtTo=2024-12-31T23:59:59Z&type=receipt,return&fiscalDayNumber=123
Authorization: MAC id="CLIENT_ID", ts="TIMESTAMP", nonce="RANDOM_STRING", mac="MAC_HASH"

Response

{
  "items": [
    {
      "id": "doc-123",
      "type": "receipt",
      "number": "RCP-2024-001",
      "amount": 5499,
      "currency": "EUR",
      "fiscalDayNumber": 125,
      "createdAt": "2024-11-04T10:15:30Z"
    },
    {
      "id": "doc-124",
      "type": "return",
      "number": "RTN-2024-001",
      "amount": 1999,
      "currency": "EUR",
      "fiscalDayNumber": 125,
      "createdAt": "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 documents created from this date (ISO 8601 format)

createdAtTo

Filter documents created until this date (ISO 8601 format)

type

Filter by document type(s)

fiscalDayNumber

Filter by fiscal day number

RESPONSE

Financial documents retrieved successfully

{
  "items": [
    {
      "id": "doc-123",
      "type": "receipt",
      "number": "RCP-2024-001",
      "amount": 5499,
      "currency": "EUR",
      "fiscalDayNumber": 125,
      "createdAt": "2024-11-04T10:15:30Z"
    },
    {
      "id": "doc-124",
      "type": "return",
      "number": "RTN-2024-001",
      "amount": 1999,
      "currency": "EUR",
      "fiscalDayNumber": 125,
      "createdAt": "2024-11-04T11:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalItems": 2,
    "totalPages": 1
  }
}