---
title: "Métadonnées d'un document et texte extrait (OCR) (v1.2)"
method: GET
path: "/documents/{id}"
tags: ["Documents"]
---

# Métadonnées d'un document et texte extrait (OCR) (v1.2)

`GET /documents/{id}`

## Request

- Base URL: `https://api.propecto.eu/v1`
- URL: `https://api.propecto.eu/v1/documents/{id}`
- Auth: one of:
  - API key in header `x-api-cle`
  - HTTP bearer

Texte extrait des pièces anciennes (OCR) ou de la page de l'avis quand il existe ; données personnelles masquées. Identifiant mal formé : 404 sans consommer de quota. Coût : 1 unité du quota journalier et 1 unité du quota mensuel « documents ».

## Path parameters

- `id` string, required

## Response `200`

Document.

- DocumentDetail: Pièce officielle connue de Propecto. Chaque pièce porte sa source, sa licence et son lien officiel (qui fait foi).
  - `id` string, required: Identifiant opaque : soc_…, obj_…, ao_…, avis_…, aod_…, aid_….
  - `famille` 'societe' | 'marche' | 'marque' | 'aide', required
  - `type_doc` string, nullable: Type de pièce (comptes_annuels, acte, statuts, avis, avis_pdf, dce, annexe, questions_reponses, visuel…).
  - `intitule` string, nullable: Intitulé donné par le déposant ou la source.
  - `date` string, nullable: Date de la pièce (millésime pour les comptes).
  - `format` string, nullable: Format annoncé par la source.
  - `mime` string, nullable: Type MIME du fichier stocké.
  - `taille_octets` integer, nullable
  - `pages` integer, nullable
  - `source` string, nullable: Source (clé du registre des licences).
  - `licence` string, nullable: Licence de réutilisation de la source.
  - `licence_url` string, nullable: Texte de la licence.
  - `statut` 'disponible' | 'a_recuperer' | 'annonce' | 'lien_seul' | 'texte_extrait' | 'erreur', required: disponible : fichier stocké chez Propecto et téléchargeable (/fichier) ; a_recuperer : copie autorisée, pas encore rapatriée ; annonce : pièce annoncée par le registre, pas encore rapatriée ; lien_seul : la licence ou l'éditeur n'autorise que le lien officiel ; texte_extrait : avis dont le texte a été lu ; erreur : dernière récupération en échec.
  - `lien_officiel` string, nullable: Adresse publique de la pièce chez l'éditeur (Source officielle).
  - `texte_disponible` boolean: Avis de marché : texte extrait disponible via /documents/{id}.
  - `maj_le` string, date-time, nullable: Dernière mise à jour chez Propecto.
  - `maj_source` string, nullable: Date de mise à jour annoncée par le producteur (citée avec la pièce).

## Other responses

- `401`: Clé absente, malformée, inconnue ou révoquée.
- `404`: Introuvable.
- `429`: Quota journalier OU quota mensuel de la famille atteint. Corps ErreurQuotaMensuel pour le mensuel ; en-tête Retry-After (secondes).
- `500`: Vérification de la clé impossible.
- `502`: Échec de la requête à la base.

---

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