Historique des statuts du cycle de vie

GET

/v1/invoices/{invoiceId}/statuses

curl --request GET \
  --url http://localhost:4000/v1/invoices/example/statuses \
  --header 'Authorization: Bearer <token>'

• Développement local

Piste d’audit horodatée (conservation 10 ans, référentiel 02).

Authorizations

• bearerAuth

Parameters

Path Parameters

invoiceId

required

string

Identifiant attribué par la passerelle (submission_id).

Responses

200

Statuts, du plus ancien au plus récent.

Media typeapplication/json

object

data

required

Array<object>

object

code

required

Statut du cycle de vie (référentiel 02 §17) : 200 Déposée, 201 Émise, 202 Reçue, 203 Mise à disposition, 204 Prise en charge, 205 Approuvée, 206 Approuvée partiellement, 207 En litige, 208 Suspendue, 209 Complétée, 210 Refusée, 211 Paiement transmis, 212 Encaissée, 213 Rejetée, 214 Visée (à vérifier : absent du référentiel 02).

integer

>= 200 <= 214

label

string

occurred_at

required

string format: date-time

reason

Motif, notamment pour 210 et 213.

string

Example ^generated

{
  "data": [
    {
      "code": 1,
      "label": "example",
      "occurred_at": "2026-04-15T12:00:00Z",
      "reason": "example"
    }
  ]
}

401

Jeton absent ou invalide.

Media typeapplication/problem+json

Erreur au format RFC 9457.

object

type

required

string format: uri-reference

title

required

string

status

required

integer

detail

string

submission_id

Dépôt existant, pour un doublon (409).

string

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "submission_id": "example"
}

404

Ressource inconnue.

Media typeapplication/problem+json

Erreur au format RFC 9457.

object

type

required

string format: uri-reference

title

required

string

status

required

integer

detail

string

submission_id

Dépôt existant, pour un doublon (409).

string

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "submission_id": "example"
}

500

Erreur interne (message générique, détail dans les logs du serveur).

Media typeapplication/problem+json

Erreur au format RFC 9457.

object

type

required

string format: uri-reference

title

required

string

status

required

integer

detail

string

submission_id

Dépôt existant, pour un doublon (409).

string

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "submission_id": "example"
}