List all invoices

GET https://pos.paysera.com/eapi/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 a Personal Access Token, sent as a Bearer token.

To obtain one, your account needs API permission. Once granted, go to /user/settings in your POS account and create a personal access token.

Authorization Header Format:

Authorization: Bearer YOUR_ACCESS_TOKEN

Example:

Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...

For more details, see the Authentication section.

Parameters

Query Parameters

Name	Type	Required	Description
pageSize	integer		Number of items per page (min: 1, max: 100)
page	integer		The current page number (min: 1)
createdAtFrom	string		Filter orders created on or after the specified UTC timestamp
createdAtTo	string		Filter orders created on or before the specified UTC timestamp
updatedAtFrom	string		Filter orders updated on or after the specified UTC timestamp
updatedAtTo	string		Filter orders updated on or before the specified UTC timestamp
numbers	array		Filter by invoice numbers (number part only, without prefix)
prefix	array		Filter by invoice prefixes
fullNumbers	array		Filter by complete invoice numbers (prefix + number combination)

Errors

This endpoint may return the following errors:

400 - Bad Request

The request was invalid or cannot be served.

401 - Unauthorized

Unauthorized

This error was produced by providing incorrect credentials.

403 - Forbidden

Forbidden

This error indicates you don't have permission to access this resource.

404 - Not Found

The requested resource could not be found.

405 - Method Not Allowed

The requested HTTP method is not allowed for this resource.

422 - Unprocessable Entity

Unprocessable entity

429 - Too Many Requests

You have exceeded the rate limit. Please try again in a minute.

500 - Internal Server Error

Internal server error

Example

Request

GET https://pos.paysera.com/eapi/v1/invoices?pageSize=10&page=1&createdAtFrom=2023-01-01T00:00:00Z&createdAtTo=2023-12-31T23:59:59Z&updatedAtFrom=2023-01-01T00:00:00Z&updatedAtTo=2023-12-31T23:59:59Z
Authorization: Bearer YOUR_ACCESS_TOKEN

Response

{
  "itemsTotal": 1,
  "pagesTotal": 1,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "prefix": "POS",
      "number": "00001",
      "fullNumber": "POS00001",
      "type": "debit",
      "currency": "EUR",
      "order": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "number": "123456"
      },
      "customer": {
        "firstName": "John",
        "lastName": "Doe",
        "companyName": "Acme Inc.",
        "companyCode": "123456789",
        "companyVat": "LT123456789",
        "billingAddress": {
          "phone": "+1-555-123-4567",
          "address1": "123 Main St",
          "address2": "Apt 4B",
          "zip": "LT12345",
          "city": "Anytown",
          "country": "LT"
        }
      },
      "invoicePositions": [
        {
          "name": "Product Name",
          "quantity": 2,
          "price": {
            "unit": {
              "regular": "45.99",
              "special": "39.99",
              "discount": "6.00",
              "globalDiscount": "2.00"
            },
            "total": {
              "withoutTax": "91.98",
              "tax": "19.32",
              "withTax": "111.30"
            },
            "tax": {
              "rate": "21.0",
              "classifier": "PVM1"
            }
          }
        }
      ],
      "totals": {
        "subtotal": "62.20",
        "discount": "5.00",
        "tax": "12.79",
        "total": "74.99"
      },
      "notes": "Additional notes",
      "issueDate": "2024-11-04T10:15:30Z",
      "createdAt": "2024-11-04T10:15:30Z"
    }
  ],
  "links": {
    "first": {
      "href": "string"
    },
    "last": {
      "href": "string"
    },
    "next": {
      "href": "string"
    },
    "prev": {
      "href": "string"
    },
    "self": {
      "href": "string"
    }
  }
}

AUTHORIZATION: HTTP

REQUEST

Base URL

https://pos.paysera.com

Query Parameters

numbers

Filter by invoice numbers (number part only, without prefix)

prefix

Filter by invoice prefixes

fullNumbers

Filter by complete invoice numbers (prefix + number combination)

RESPONSE

Invoices retrieved successfully

{
  "itemsTotal": 1,
  "pagesTotal": 1,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "prefix": "POS",
      "number": "00001",
      "fullNumber": "POS00001",
      "type": "debit",
      "currency": "EUR",
      "order": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "number": "123456"
      },
      "customer": {
        "firstName": "John",
        "lastName": "Doe",
        "companyName": "Acme Inc.",
        "companyCode": "123456789",
        "companyVat": "LT123456789",
        "billingAddress": {
          "phone": "+1-555-123-4567",
          "address1": "123 Main St",
          "address2": "Apt 4B",
          "zip": "LT12345",
          "city": "Anytown",
          "country": "LT"
        }
      },
      "invoicePositions": [
        {
          "name": "Product Name",
          "quantity": 2,
          "price": {
            "unit": {
              "regular": "45.99",
              "special": "39.99",
              "discount": "6.00",
              "globalDiscount": "2.00"
            },
            "total": {
              "withoutTax": "91.98",
              "tax": "19.32",
              "withTax": "111.30"
            },
            "tax": {
              "rate": "21.0",
              "classifier": "PVM1"
            }
          }
        }
      ],
      "totals": {
        "subtotal": "62.20",
        "discount": "5.00",
        "tax": "12.79",
        "total": "74.99"
      },
      "notes": "Additional notes",
      "issueDate": "2024-11-04T10:15:30Z",
      "createdAt": "2024-11-04T10:15:30Z"
    }
  ],
  "links": {
    "first": {
      "href": "string"
    },
    "last": {
      "href": "string"
    },
    "next": {
      "href": "string"
    },
    "prev": {
      "href": "string"
    },
    "self": {
      "href": "string"
    }
  }
}