---
title: "Suivi d’un envoi postal"
method: GET
path: "/v1/mailings/{id}"
tags: ["B2B (v1)"]
---

# Suivi d’un envoi postal

`GET /v1/mailings/{id}`

## Request

- Base URL: `https://api.vitef.com`
- URL: `https://api.vitef.com/v1/mailings/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Response `200`

Envoi

- Shipment
  - `title` string, required
  - `mode` 'simple' | 'rec' | 'ar' | 'lre', required
  - `modeLabel` string, required
  - `status` 'paid' | 'printed' | 'posted' | 'in_transit' | 'delivered' | 'ar_signed' | 'returned' | 'error' | 'canceled', required
  - `statusLabel` string, required
  - `step` integer, required
  - `lastStep` integer, required: 4 (simple, recommandé) ou 5 (recommandé avec AR).
  - `trackingNumber` string
  - `createdAt` string, required
  - `events` ShipmentEvent[], required
    - `step` integer, required: 0 payée, 1 imprimée, 2 remise à La Poste, 3 acheminement, 4 distribuée, 5 AR signé.
    - `status` 'paid' | 'printed' | 'posted' | 'in_transit' | 'delivered' | 'ar_signed' | 'returned' | 'error' | 'canceled', required
    - `label` string, required
    - `at` string, required
  - `id` string, required
  - `orderId` string, nullable, required
  - `recipient` string[], required
  - `recipientEmail` string: LRE : adresse e-mail du destinataire.
  - `amountCents` integer, required
  - `reference` string, nullable, required
  - `test` boolean, required: Envoi simulé (clé vf_test_) : rien n’est posté.
  - `proofs` object[], required: Preuves disponibles (dépôt, accusé de réception…), à télécharger via …/proofs/{kind}.
    - `kind` 'filing' | 'delivery' | 'return' | 'download' | 'rejection' | 'negligence', required
    - `label` string, required
  - `contentProof` object: Recommandé papier (hors API B2B) : preuve de contenu, une fois la lettre remise à La Poste. Gardée 5 ans.
    - `label` string, required
    - `sha256` string, required: Empreinte SHA-256 du document exact remis à l’impression.
    - `url` string, uri, required: Lien signé et durable vers l’attestation PDF.
  - `document` PlainLetter: Lettre entièrement textuelle (sans champ à compléter), telle qu’imprimée et envoyée.
    - `title` string, required
    - `sender` string[], required
    - `recipient` string[], required
    - `place` string, required
    - `date` string, required
    - `subject` string, required
    - `body` string[], required
    - `signature` string, required
    - `signatureImage` string: Signature dessinée, en data URL PNG (fond transparent conseillé, 200 k caractères au plus). Imprimée au-dessus du nom.

## Other responses

- `400`: Requête invalide
- `401`: Authentification requise ou invalide
- `403`: Accès refusé (`insufficient_scope`, `account_suspended`, `live_not_enabled`)
- `404`: Ressource introuvable
- `429`: Trop de requêtes
- `500`: Erreur interne

---

[API](https://skmtc.dev/vitef/apis/api-vitef.md) · [All operations](https://skmtc.dev/vitef/apis/api-vitef/llms.txt) · [OpenAPI document](https://skmtc.dev/vitef/apis/api-vitef/revisions/7bc459d9ef90?raw)