Lister les factures d'un mandat (paginées)

GET

/v1/invoices

curl --request GET \
  --url 'https://example.com/v1/invoices?pageSize=20&page=1&mandateId=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0' \
  --header 'X-API-Key: <X-API-Key>'

Authorizations

• ApiKeyAuth
• BearerAuth

Parameters

Query Parameters

pageSize

integer

default: 20 >= 1 <= 100

page

integer

default: 1 >= 1

to

string format: date

from

string format: date

mandateId

required

string format: uuid

Responses

200

Liste paginée de factures

Media type application/json

object

data

required

Array<object>

object

id

required

string format: uuid

invoiceNumber

required

string

invoiceKind

required

string

Allowed values: standard deposit final

invoiceDate

required

string format: date

status

required

string

Allowed values: draft finalized issued cancelled

totalHt

required

object

amountCents

required

Montant en centimes (bigint sérialisé en string)

string

currency

required

string

Allowed values: EUR GBP

totalTax

required

object

amountCents

required

Montant en centimes (bigint sérialisé en string)

string

currency

required

string

Allowed values: EUR GBP

totalTtc

required

object

amountCents

required

Montant en centimes (bigint sérialisé en string)

string

currency

required

string

Allowed values: EUR GBP

operatingMandateId

required

string format: uuid

folioId

required

string format: uuid

billToName

required

string

siren

required

SIREN de l’émetteur (assujetti, snapshotté à l’émission)

string

servicePeriodFrom

string format: date

nullable

servicePeriodTo

string format: date

nullable

lines

required

Array<object>

object

id

required

string format: uuid

label

required

string

quantity

required

integer

>= 1

chargeType

required

string

chargeNature

required

string

Allowed values: revenue disbursement collected_tax penalty advance_deduction

amountHt

required

object

amountCents

required

Montant en centimes (bigint sérialisé en string)

string

currency

required

string

Allowed values: EUR GBP

taxRate

required

Taux TVA en % (ex: “10.00”)

string

taxAmount

required

object

amountCents

required

Montant en centimes (bigint sérialisé en string)

string

currency

required

string

Allowed values: EUR GBP

currency

required

string

sourceFolioEntryId

string format: uuid

nullable

sequenceType

required

string

Allowed values: invoice credit_note

correctedInvoiceId

required

string format: uuid

nullable

creditNoteReason

string

nullable

creditNotes

Array<object>

object

id

required

string format: uuid

invoiceNumber

required

string

meta

required

object

page

required

integer

>= 1

pageSize

required

integer

>= 1

total

required

integer

Example

{
  "data": [
    {
      "invoiceNumber": "FAC-2026-0000001",
      "invoiceKind": "standard",
      "status": "draft",
      "totalHt": {
        "amountCents": "12000",
        "currency": "EUR"
      },
      "totalTax": {
        "amountCents": "12000",
        "currency": "EUR"
      },
      "totalTtc": {
        "amountCents": "12000",
        "currency": "EUR"
      },
      "billToName": "Jean Dupont",
      "siren": "123456789",
      "lines": [
        {
          "label": "Nuitée chambre double",
          "quantity": 1,
          "chargeType": "room_night",
          "chargeNature": "revenue",
          "amountHt": {
            "amountCents": "12000",
            "currency": "EUR"
          },
          "taxRate": "10.00",
          "taxAmount": {
            "amountCents": "12000",
            "currency": "EUR"
          },
          "currency": "EUR"
        }
      ],
      "sequenceType": "invoice",
      "creditNotes": [
        {
          "invoiceNumber": "AV-2026-0000001"
        }
      ]
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "total": 42
  }
}

401

Non authentifié

Media type application/json

object

code

required

Code machine de l’erreur

string

message

required

Message lisible

string

origin

Origine domaine de l’erreur (optionnel)

object

boundedContext

string

module

string

status

required

integer

traceId

required

Identifiant de corrélation pour le support

string

Example

{
  "code": "RESERVATION_NOT_FOUND",
  "message": "Réservation introuvable",
  "status": 404
}

403

Permission refusée ou périmètre non vérifiable

Media type application/json

object

code

required

Code machine de l’erreur

string

message

required

Message lisible

string

origin

Origine domaine de l’erreur (optionnel)

object

boundedContext

string

module

string

status

required

integer

traceId

required

Identifiant de corrélation pour le support

string

Example

{
  "code": "RESERVATION_NOT_FOUND",
  "message": "Réservation introuvable",
  "status": 404
}