List of invoices

get

https://api-staging.b2brouter.net/accounts/{account}/invoices

Returns a paginated list of the invoices of the account.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

account

string

required

Account identifier (ID)

Query Params

offset

integer

Defaults to 0

Jump to the first object.

limit

integer

Defaults to 25

Number of items in the response (500 maximum)

type

string

enum

Defaults to IssuedInvoice

Filter on invoice type.

Allowed:

ack

boolean

Filter documents with ACK.

date_from

date

Filter from submission date.

date_to

date

Filter to submission date

due_date_from

date

Filter from due date

due_date_to

date

Filter to due date

number

string

Filter on invoice number. Performs an exact match search; only invoices with an invoice number exactly equal to the specified value will be returned

state_updated_at_from

date

Filter on change status date. Invoices with change status date later than the specified date are returned

updated_at_from

date

Filter on updated_at date. Entities with updated_at date later than the specified date are returned.

tin_value

string

Filter on customer VAT code

cin_value

string

Filter on customer Company Identification Number

new

integer

enum

0 to 1

Filter on invoice status "new". Created and ready to be sent

Allowed:

sending

integer

enum

0 to 1

Filter on invoice status "sending". Invoice is being sent

Allowed:

error

integer

enum

0 to 1

Filter on invoice status "error". An error has been raised when sending the invoice to its recipient

Allowed:

sent

integer

enum

0 to 1

Filter on invoice status "sent". Successfully sent to its recipient

Allowed:

refused

integer

enum

0 to 1

Filter on invoice status "refused". The recipient has refused the invoice. Usually, the reason for the rejection is provided

Allowed:

closed

integer

enum

0 to 1

Filter on invoice status "closed". The sender considers that the invoice is closed and does not want to perform further operations

Allowed:

registered

integer

enum

0 to 1

Filter on invoice status "registered". The receiver has registered the invoice. Some receivers may indicate a registration number

Allowed:

accepted

integer

enum

0 to 1

Filter on invoice status "accepted". The receiver has accepted the invoice

Allowed:

downloaded

integer

enum

0 to 1

Filter on invoice status "downloaded".

Allowed:

annotated

integer

enum

0 to 1

Filter on invoice status "annotated".

Allowed:

allegedly_paid

integer

enum

0 to 1

Filter on invoice status "allegedly_paid". The receiver has indicated that he has ordered the payment of the invoice

Allowed:

paid

integer

enum

0 to 1

Filter on invoice status "paid".

Allowed:

received

integer

enum

0 to 1

Filter on received invoices with status "received".

Allowed:

ocr_failed

integer

enum

0 to 1

Filter on received invoices with status "ocr_failed".

Allowed:

exclude_offices

integer

enum

0 to 1

Do not show the invoices of the Organizational Units.

Allowed:

from_net

string

Filter on received invoice from net value. Use as a string search, for example, searching "api" lists all the received invoices that are received via API.

Headers

X-B2B-API-Version

string

Defaults to 2026-04-20

Specifies the version of the API to use in this request. If not specified uses the API-Version set in the group conifguration B2Brouter UI Application -> Developers -> API Keys -> API Version

Response

200Successful operation