List all invoices

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

Retrieve a paginated list of invoices with optional filtering.

Filtering Options

• Date range (creation and update dates)
• Invoice numbers
• Invoice prefix
• Full invoice numbers

Invoices are generated from completed orders and contain detailed billing information.

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 invoices created from this date
createdAtTo	string		Filter invoices created until this date
updatedAtFrom	string		Filter invoices updated from this date
updatedAtTo	string		Filter invoices updated until this date
numbers	array		Filter by specific invoice numbers
prefix	array		Filter by invoice prefix(es)
fullNumbers	array		Filter by full invoice numbers (prefix + number)

Example

Request

GET https://pos.paysera.com/epapi/v1/invoices?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&numbers=001,002&prefix=INV,PRO&fullNumbers=INV-001,PRO-002
Authorization: MAC id="CLIENT_ID", ts="TIMESTAMP", nonce="RANDOM_STRING", mac="MAC_HASH"

Response

{
  "items": [
    {
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "number": "001",
      "prefix": "INV",
      "fullNumber": "INV-001",
      "totalAmount": 5499,
      "currency": "EUR",
      "status": "paid",
      "createdAt": "2024-11-04T10:15:30Z",
      "updatedAt": "2024-11-04T10:20:45Z"
    },
    {
      "uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "number": "002",
      "prefix": "INV",
      "fullNumber": "INV-002",
      "totalAmount": 1999,
      "currency": "EUR",
      "status": "pending",
      "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 invoices created from this date

createdAtTo

Filter invoices created until this date

updatedAtFrom

Filter invoices updated from this date

updatedAtTo

Filter invoices updated until this date

numbers

Filter by specific invoice numbers

prefix

Filter by invoice prefix(es)

fullNumbers

Filter by full invoice numbers (prefix + number)

RESPONSE

Invoices retrieved successfully

{
  "items": [
    {
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "number": "001",
      "prefix": "INV",
      "fullNumber": "INV-001",
      "totalAmount": 5499,
      "currency": "EUR",
      "status": "paid",
      "createdAt": "2024-11-04T10:15:30Z",
      "updatedAt": "2024-11-04T10:20:45Z"
    },
    {
      "uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "number": "002",
      "prefix": "INV",
      "fullNumber": "INV-002",
      "totalAmount": 1999,
      "currency": "EUR",
      "status": "pending",
      "createdAt": "2024-11-04T11:30:00Z",
      "updatedAt": "2024-11-04T11:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalItems": 2,
    "totalPages": 1
  }
}