List invoices

GET

/invoices

Returns a paginated list of invoices for the authenticated user. Supports filtering by status, payment type, date range, amount range, and specific IDs.

Authorizations

token

Parameters

Query Parameters

page

integer

default: 1 >= 1

Current page

_order[created_at]

Sort order direction (ascending or descending)

string

default: asc

Allowed values: asc desc

Sort by timestamp when the entity was created

_order[amount]

Sort order direction (ascending or descending)

string

default: asc

Allowed values: asc desc

Sort by document amount

status

integer

Exact filter by the document status

paymentType

integer

Exact filter by the payment type

integer

Exact filter by the document ID

id[]

Array<integer>

Exact filter by multiple document IDs

created_at

integer

Exact filter by the creation timestamp

created_at[]

Array<integer>

Exact and range filter by the creation timestamps

amount

number

Range filter by the document amount (real value, e.g. 24.63 for 24.63 EUR)

amount[]

Array<number>

Exact and range filter by the document amounts (real values, e.g. 24.63 for 24.63 EUR)

paid_at

integer

Exact filter by the payment timestamp

paid_at[]

Array<integer>

Exact and range filter by the payment timestamps

exists[paid_at]

boolean

Exists filter for payment status: true = paid documents, false = unpaid documents

Responses

200

Invoice collection

object

@context

One of:

string
object

string

@id

JSON-LD ID

string

@type

JSON-LD type

string

member

Array<object>

Invoice details (JSON-LD)

object

@id

JSON-LD ID

string

@type

JSON-LD type

string

@context

One of:

string
object

string

Invoice ID

string

created_at

Creation date (unix timestamp)

integer

amount

Invoice amount

number

currency

Currency

string

default: EUR

Allowed values: EUR CHF

status

Invoice status: 0 = New (unpaid), 1 = Success (paid), 2 = Failed

integer

Allowed values: 0 1 2

payment_type

Payment method: 1 = SEPA, 6 = Bank Transfer, 7 = PayPal, 8 = Sofort, 91 = Stored Card, 92 = New Card

integer

Allowed values: 1 6 7 8 91 92

paid_at

Payment date (unix timestamp), 0 if not paid

integer

client_name

Client company name

string

client_address

Client address

string

client_info

Client info line

string

vat

VAT percentage

number

vat_id

VAT identification number

string

vat_val

VAT value

number

fee

Fee percentage

number

fee_val

Fee value

number

net_val

Net cost value

number

iso2

ISO-2 country code

string

custom_text

Custom text on the invoice

string

pdf

URI to download invoice PDF

string

credit_note

URI to related credit note, null if none

string | null

key

additional properties

any

hydra:totalItems

Total number of items in the collection

integer

hydra:view

Pagination links for navigating the collection

object

@id

string format: iri-reference

@type

string

hydra:first

string format: iri-reference

hydra:last

string format: iri-reference

hydra:previous

string format: iri-reference

hydra:next

string format: iri-reference

hydra:search

Search and filtering template for the collection

object

@type

string

hydra:template

string

hydra:variableRepresentation

string

hydra:mapping

Array<object>

object

@type

string

variable

string

property

string | null

required

boolean

key

additional properties

any

Examples

invoices_jsonld

Invoice list example (JSON-LD)

Example response for GET /invoices with Accept: application/ld+json

{
  "@context": "/contexts/Invoice",
  "@id": "/invoices",
  "@type": "Collection",
  "totalItems": 1,
  "member": [
    {
      "@id": "/invoices/44969",
      "@type": "Invoice",
      "id": "44969",
      "created_at": 1626123015,
      "amount": 24.63,
      "currency": "EUR",
      "status": 1,
      "payment_type": 7,
      "paid_at": 1626123015,
      "client_name": "Example Customer Ltd.",
      "client_address": "Main Street 42\n12345 Example City",
      "client_info": "John Doe",
      "vat": 19,
      "vat_id": "DE123456789",
      "vat_val": 3.93,
      "fee": 3.5,
      "fee_val": 0.72,
      "net_val": 19.98,
      "iso2": "DE",
      "custom_text": "PO-2024-001",
      "pdf": "/invoices/44969/pdf",
      "credit_note": null
    }
  ],
  "view": {
    "@id": "/invoices?page=1",
    "@type": "PartialCollectionView"
  },
  "search": {
    "@type": "IriTemplate",
    "template": "/invoices{?_order[created_at],_order[amount],status,status[],payment_type,payment_type[],id,id[],createdAt[between],createdAt[gt],createdAt[gte],createdAt[lt],createdAt[lte],amount[between],amount[gt],amount[gte],amount[lt],amount[lte],paidAt[between],paidAt[gt],paidAt[gte],paidAt[lt],paidAt[lte]}",
    "variableRepresentation": "BasicRepresentation",
    "mapping": [
      {
        "@type": "IriTemplateMapping",
        "variable": "_order[created_at]",
        "property": "created_at",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "_order[amount]",
        "property": "amount",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "status",
        "property": "status",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "status[]",
        "property": "status",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "payment_type",
        "property": "payment_type",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "payment_type[]",
        "property": "payment_type",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "id",
        "property": "id",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "id[]",
        "property": "id",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "createdAt[between]",
        "property": "createdAt",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "createdAt[gt]",
        "property": "createdAt",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "createdAt[gte]",
        "property": "createdAt",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "createdAt[lt]",
        "property": "createdAt",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "createdAt[lte]",
        "property": "createdAt",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "amount[between]",
        "property": "amount",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "amount[gt]",
        "property": "amount",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "amount[gte]",
        "property": "amount",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "amount[lt]",
        "property": "amount",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "amount[lte]",
        "property": "amount",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "paidAt[between]",
        "property": "paidAt",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "paidAt[gt]",
        "property": "paidAt",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "paidAt[gte]",
        "property": "paidAt",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "paidAt[lt]",
        "property": "paidAt",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "paidAt[lte]",
        "property": "paidAt",
        "required": false
      }
    ]
  }
}

Array<object>

Invoice details

object

Invoice ID

string

created_at

Creation date (unix timestamp)

integer

amount

Invoice amount

number

currency

Currency

string

default: EUR

Allowed values: EUR CHF

status

Invoice status: 0 = New (unpaid), 1 = Success (paid), 2 = Failed

integer

Allowed values: 0 1 2

payment_type

Payment method: 1 = SEPA, 6 = Bank Transfer, 7 = PayPal, 8 = Sofort, 91 = Stored Card, 92 = New Card

integer

Allowed values: 1 6 7 8 91 92

paid_at

Payment date (unix timestamp), 0 if not paid

integer

client_name

Client company name

string

client_address

Client address

string

client_info

Client info line

string

vat

VAT percentage

number

vat_id

VAT identification number

string

vat_val

VAT value

number

fee

Fee percentage

number

fee_val

Fee value

number

net_val

Net cost value

number

iso2

ISO-2 country code

string

custom_text

Custom text on the invoice

string

pdf

URI to download invoice PDF

string

credit_note

URI to related credit note, null if none

string | null

key

additional properties

any

Examples

invoices_json

Invoice list example (JSON)

Example response for GET /invoices with Accept: application/json

[
  {
    "id": "44969",
    "created_at": 1626123015,
    "amount": 24.63,
    "currency": "EUR",
    "status": 1,
    "payment_type": 7,
    "paid_at": 1626123015,
    "client_name": "Example Customer Ltd.",
    "client_address": "Main Street 42\n12345 Example City",
    "client_info": "John Doe",
    "vat": 19,
    "vat_id": "DE123456789",
    "vat_val": 3.93,
    "fee": 3.5,
    "fee_val": 0.72,
    "net_val": 19.98,
    "iso2": "DE",
    "custom_text": "PO-2024-001",
    "pdf": "/invoices/44969/pdf",
    "credit_note": null
  }
]

401

Client ID or API key isn’t active or invalid!

403

Account isn’t activated. Please wait or contact to support!

429

IP address was temporary blocked, because during short time from it was sent many request with invalid credentials. Please wait and try later.

Code Samples

curl -s 'https://api.lox24.eu/invoices' -H 'X-LOX24-AUTH-TOKEN: YOUR_API_TOKEN' | jq

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("X-LOX24-AUTH-TOKEN", "YOUR_API_TOKEN");

        var response = await client.GetStringAsync("https://api.lox24.eu/invoices");
        Console.WriteLine(response);
    }
}

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.lox24.eu/invoices", nil)
  req.Header.Set("X-LOX24-AUTH-TOKEN", "YOUR_API_TOKEN")

  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()
  body, _ := io.ReadAll(resp.Body)
  fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.lox24.eu/invoices"))
                .header("X-LOX24-AUTH-TOKEN", "YOUR_API_TOKEN")
                .GET()
                .build();

        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

<?php

$ch = curl_init('https://api.lox24.eu/invoices');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-LOX24-AUTH-TOKEN: YOUR_API_TOKEN']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response;