# Retrieve a schema

Get the details of a specific extract schema by its ID.

Endpoint: GET /schema/{id}/
Version: 0.8.1
Security: tokenAuth

## Path parameters:

  - `id` (string, required)
    The UUID of the extract schema.

## Response 200 fields (application/json):

  - `id` (string, required)
    Example: "300f339f-da71-4f9f-80f6-c25a63baae75"

  - `name` (string, required)
    Example: "Invoice schema"

  - `description` (string, required)
    Example: "Schema used for extracting data from customs invoices"

  - `additional_informations` (string,null)
    Free-form context to help the AI interpret the document (business jargon, abbreviations, locale/date/currency formats, vendor aliases, layout quirks). Use this when relevant details are missing from the file itself.
    Example: "Common abbreviations: \"CB\" = credit card, \"TVA\" = VAT. Amounts use a comma as the decimal separator.\n"

  - `schema` (object,null, required)
    Schema definition in OpenAPI JSON format

  - `created_at` (string)
    Example: "2025-06-12T14:56:10.682461Z"

  - `updated_at` (string)
    Example: "2025-06-12T14:56:10.682461Z"

## Response 401 fields (application/json):

  - `detail` (string, required)
    Message principal de l'erreur
    Example: "Given token not valid for any token type"

  - `code` (string, required)
    Code d'erreur JWT
    Example: "token_not_valid"

  - `messages` (array, required)
    Liste des messages d'erreur détaillés

  - `messages.token_class` (string, required)
    Type de token JWT
    Example: "AccessToken"

  - `messages.token_type` (string, required)
    Type de token (ex: access)
    Example: "access"

  - `messages.message` (string, required)
    Description de l'erreur
    Example: "Token is expired"

## Response 404 fields (application/json):

  - `detail` (string)
    Example: "No Extract matches the given query."