# Retrieve an audio.

Use this endpoint to retrieve an audio information.

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

## Security:

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

## Path parameters:

  - `uuid` (string, required)
    Audio identifier

## Query parameters:

  - `expand[]` (array)

## Response 200:

  - `200` (unknown)
    Audio resource

## Response 200 fields (application/json):

  - `uuid` (string)
    Audio unique identifier.

  - `patient` (any)
    Audio 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.user.uuid` (string)
    User unique identifier.

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

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

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

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

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

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

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

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

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

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

  - `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"

  - `createdAt` (string)
    Audio creation date.

  - `updatedAt` (string)
    Audio update date.

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

  - `documents` (array)
    Audio associated documents.

  - `documents.uuid` (string)
    Document unique identifier.

  - `documents.createdAt` (string)
    Document creation date.

  - `documents.updatedAt` (string)
    Document update date.

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

  - `documents.patient` (any)
    Document patient.

  - `documents.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"

  - `documents.pdf` (any)
    Document PDF file.

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

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

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

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

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

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

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

  - `documents.isAnonymized` (boolean)
    Document anonymization status.

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

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

  - `documents.documentIntegrations.client` (any)
    Third party integration.

  - `documents.documentIntegrations.client.identifier` (string)
    OAuth client unique identifier.

  - `documents.documentIntegrations.client.name` (string)
    OAuth client name.

  - `documents.documentIntegrations.client.description` (string | null)
    OAuth client description.

  - `documents.documentIntegrations.client.slug` (string | null)
    OAuth client slug.

  - `documents.documentIntegrations.client.logoUrl` (string | null)
    OAuth client logo URL.

  - `documents.documentIntegrations.client.iconUrl` (string | null)
    OAuth client icon URL (small icon displayed next to patient name).

  - `documents.documentIntegrations.client.status` (string)
    OAuth client status.
    Enum: "available", "available_soon", "not_available"

  - `documents.documentIntegrations.client.countries` (array | null)
    Countries where this client is relevant (ISO 3166-1 alpha-2 codes).

  - `documents.documentIntegrations.client.systems` (array | null)
    Operating systems supported by this client (mac, windows, web). Used by Askara Hub to filter apps per platform.

  - `documents.documentIntegrations.client.specialties` (array | null)
    Medical specialties targeted by this client.

  - `documents.documentIntegrations.client.clientTypes` (array | null)
    Type categories of this client application.

  - `documents.documentIntegrations.client.createdAt` (string)
    OAuth client creation date.

  - `documents.documentIntegrations.client.updatedAt` (string | null)
    OAuth client update date.

  - `documents.documentIntegrations.client.integrationPageMarkdown` (string | null)
    Integration page content in Markdown format (localized).

  - `documents.documentIntegrations.client.tutorialMarkdown` (string | null)
    Tutorial content in Markdown format (localized) - can include images/GIFs.

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

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

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

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

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

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

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

  - `documents.documentIntegrations.claimedByClient` (any)
    OAuth client that claimed/downloaded the document (e.g., Electron app).

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

  - `documents.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"

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

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

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

  - `images` (array)
    Audio associated images.

  - `images.uuid` (string)
    Image unique identifier.

  - `images.title` (string | null)
    Image title.

  - `images.name` (string)
    Image file name.

  - `images.size` (integer)
    Image file size.

  - `images.createdAt` (string)
    Image creation date.

  - `images.updatedAt` (string)
    Image update date.

  - `images.fileUrl` (string | null)
    Permanent image file URL (HMAC signed, never expires). Use this URL for embedding in documents.

  - `meeting` (string | null)
    Associated meeting.
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `user` (any)
    Audio user (author).

  - `languageSpoken` (string | null)
    Audio spoken language.

  - `mediaRecorderType` (string | null)
    Get the media recorder type of this audio.

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

## 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)