# Retrieve a document entity.

Use this endpoint to retrieve a document information.

Endpoint: GET /documents/{uuid}
Version: 1.94.0
Security: oauth_auth_code

## Security:

  - `oauth_auth_code` (unknown)
    oauth2 scopes: read:documents

## Path parameters:

  - `uuid` (string, required)
    Document identifier

## Query parameters:

  - `expand[]` (array)

## Response 200:

  - `200` (unknown)
    Document resource

## Response 200 fields (application/json):

  - `uuid` (string)
    Document unique identifier.

  - `createdAt` (string)
    Document creation date.

  - `updatedAt` (string)
    Document update date.

  - `encounteredAt` (string | null)
    Document operation/cone beam specific date.

  - `user` (object)

  - `user.uuid` (string)
    User unique identifier.

  - `user.email` (string, required)
    User email address.

  - `user.createdAt` (string)
    User creation date.

  - `user.updatedAt` (string)
    User update date.

  - `user.firstName` (string | null, required)
    User first name.

  - `user.lastName` (string | null, required)
    User last name.

  - `user.gender` (string | null)
    User gender.
    Enum: "female", "male", "unknown", "null"

  - `user.phone` (string | null)
    User phone number.
    Example: +33757590893

  - `user.rpps` (string | null)
    User RPPS number (France).
    Example: 10101748050

  - `user.am` (string | null)
    User AM number (France).
    Example: 394003552

  - `user.isConventionne` (boolean)
    Whether the practitioner is "conventionne" (national administrative fact, sourced from the Ameli extract). Read-only.

  - `patient` (any)
    Document patient.

  - `patient.uuid` (string)
    Patient unique identifier.

  - `patient.firstName` (string | null, required)
    Patient first name.

  - `patient.lastName` (string | null, required)
    Patient last name.

  - `patient.languageSpoken` (string)
    Patient language.

  - `patient.createdAt` (string)
    Patient creation date.

  - `patient.updatedAt` (string)
    Patient update date.

  - `patient.synchronizedAt` (string | null)
    Patient synchronization date.

  - `patient.dateOfBirth` (string | null)
    Patient date of birth. Must be strictly before today.

  - `patient.gender` (string | null)
    Patient gender.
    Enum: "female", "male", "unknown", "null"

  - `patient.user` (any)
    Patient author.

  - `patient.visibilityOption` (string | null)
    Enum: "shared", "private", "null"

  - `patient.email` (string | null)
    Patient email address.

  - `patient.phone` (string | null)
    Patient phone number.
    Example: +33757590893

  - `patient.anonymousCode` (string | null)
    Patient anonymous code.

  - `patient.recordNumber` (string | null)
    Patient record/folder number from the source software (e.g. Logosw).

  - `patient.civility` (string | null)
    How the patient is addressed: mr | mrs | dr | pr | none. Null means nobody has declared it — clients fall back to the gender-derived form. Distinct from `gender`: a patient who is a doctor is addressed "Dr" whatever their gender.
    Enum: "mr", "mrs", "dr", "pr", "none", "null"

  - `audio` (any)

  - `audio.uuid` (string)
    Audio unique identifier.

  - `audio.patient` (any)
    Audio patient.

  - `audio.createdAt` (string)
    Audio creation date.

  - `audio.updatedAt` (string)
    Audio update date.

  - `audio.archivedAt` (string | null)
    Audio archive date.

  - `audio.audioWorkflowStepV3` (string)
    Get the current audio workflow step (v3).
    Enum: "audio_recording", "transcription", "transcribed", "edition", "validated", "failed"

  - `type` (string | null)
    Document type.
    Enum: "operative_report", "referral_letter", "cone_beam_report", "patient_letter", "prescription", "initial_medical_certificate", "attendance_certificate", "contraindication_certificate", "lab_slip", "endo_report", "ortho_letter", "meeting_report", "intervention_report", "panoramic_report", "administrative_report", "free_letter", "null"

  - `pdf` (any)
    Document PDF file.

  - `pdf.uuid` (string)
    PDF unique identifier.

  - `pdf.name` (string | null)
    PDF name.

  - `pdf.size` (integer | null)
    PDF size.

  - `pdf.createdAt` (string)
    PDF creation date.

  - `pdf.updatedAt` (string)
    PDF creation date.

  - `pdf.url` (string | null)
    PDF file URL.

  - `pdf.fileName` (string | null)
    PDF file name.

  - `isAnonymized` (boolean)
    Document anonymization status.

  - `documentIntegrations` (array)
    Document integrations with third-party software.

  - `documentIntegrations.uuid` (string)
    Document integration unique identifier.

  - `documentIntegrations.client` (string | null)
    Third party integration.
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `documentIntegrations.path` (string | null)
    Full file path where the document is stored on the third party system.

  - `documentIntegrations.directory` (string | null)
    Third party software identifier (e.g., "logosw", "julie", "desktop").

  - `documentIntegrations.tryCount` (integer | null)
    Synchronization try count.

  - `documentIntegrations.lastTryAt` (string | null)
    Last synchronization try date.

  - `documentIntegrations.synchronizedAt` (string | null)
    Synchronization date.

  - `documentIntegrations.claimedAt` (string | null)
    Claim date (when download was reserved by a gateway instance).

  - `documentIntegrations.appVersion` (string | null)
    App version of the gateway that performed the sync.

  - `documentIntegrations.claimedByClient` (string | null)
    OAuth client that claimed/downloaded the document (e.g., Electron app).
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `documentIntegrations.errorMessage` (string | null)
    Error message if synchronization failed.

  - `documentIntegrations.errorCode` (string | null)
    Categorized reason why synchronization failed. Lets clients branch on a stable identifier instead of parsing errorMessage.
    Enum: "client_timeout", "client_webhook_unacknowledged", "client_error", "client_error_unclaimed", "null"

  - `documentIntegrations.createdAt` (string)
    Creation date.

  - `documentIntegrations.updatedAt` (string)
    Update date.

  - `genericContactSpecialty` (string | null)
    Generic contact specialty when no specific contact is selected (free text or predefined value).

## Response 200 fields (application/ld+json):

  - `@context` (any)

  - `@context.@vocab` (string, required)

  - `@context.hydra` (string, required)
    Enum: "http://www.w3.org/ns/hydra/core#"

  - `@id` (string, required)

  - `@type` (string, required)

## Response 403:

  - `403` (unknown)
    Forbidden

## Response 403 fields (application/ld+json):

  - `@context` (any)

  - `@context.@vocab` (string, required)

  - `@context.hydra` (string, required)
    Enum: "http://www.w3.org/ns/hydra/core#"

  - `@id` (string, required)

  - `@type` (string, required)

  - `title` (string | null)
    A short, human-readable summary of the problem.

  - `detail` (string | null)
    A human-readable explanation specific to this occurrence of the problem.

  - `status` (integer | null)

  - `instance` (string | null)
    A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

  - `type` (string)
    A URI reference that identifies the problem type

  - `description` (string | null)

## Response 404:

  - `404` (unknown)
    Not found

## Response 404 fields (application/ld+json):

  - `@context` (any)

  - `@context.@vocab` (string, required)

  - `@context.hydra` (string, required)
    Enum: "http://www.w3.org/ns/hydra/core#"

  - `@id` (string, required)

  - `@type` (string, required)

  - `title` (string | null)
    A short, human-readable summary of the problem.

  - `detail` (string | null)
    A human-readable explanation specific to this occurrence of the problem.

  - `status` (integer | null)

  - `instance` (string | null)
    A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

  - `type` (string)
    A URI reference that identifies the problem type

  - `description` (string | null)