# Get flight permit by ID

Retrieves detailed information about a specific flight permit including associated documents.

Features:
- Returns complete permit details including document references
- Includes creation and update timestamps

Note: This endpoint is for operators within the context of the operator data. For FL3XX Partner Providers, use the /partners endpoints instead.

Example Use Case: An operations manager needs to review the complete details of a specific permit, including any uploaded documents, to verify compliance or prepare for audits.

Endpoint: GET /api/v2/flight-permits/{flightPermitId}
Version: 2.4.0
Security: X-Api-Client-Id, X-Auth-Token

## Path parameters:

  - `flightPermitId` (string, required)
    The unique identifier of the flight permit to retrieve
    Example: "permit-12345"

## Response 200 fields (application/json):

  - `id` (string)
    Unique identifier for the flight permit
    Example: "permit-12345"

  - `permitNumber` (string)
    Permit number or reference identifier
    Example: "PER-2025-001"

  - `status` (string)
    Status of the flight permit. The status indicates the current state of the permit request or approval.

- INIT: Initial state
- NA: Not applicable
- NR: Not requested
- REQ: Requested
- HOLD: On hold
- DO: Done/Approved
- OK: Confirmed
- CNL: Cancelled
- OK_REVISED, REQ_REVISED, HOLD_REVISED, DO_REVISED: Revised statuses
    Enum: "NA", "NR", "DO", "HOLD", "REQ", "OK", "INIT", "OK_REVISED", "REQ_REVISED", "HOLD_REVISED", "DO_REVISED", "CNL"

  - `notes` (string)
    Additional notes or comments about the permit
    Example: "Permit approved for landing at LMML"

  - `tripProviderId` (string)
    Unique identifier of the trip provider associated with the permit
    Example: "provider-123"

  - `providerPublicId` (string)
    Public identifier of the permit provider
    Example: "provider-public-abc"

  - `type` (string)
    Type of flight permit. Indicates the nature of the permission required.

- TAKEOFF: Permission for takeoff from an airport
- LANDING: Permission for landing at an airport
- OVERFLIGHT: Permission to overfly a country or airspace
    Enum: "TAKEOFF", "LANDING", "OVERFLIGHT"

  - `externalNotes` (string)
    External notes or comments from the permit provider
    Example: "Additional requirements apply"

  - `externalStatus` (string)
    External status from the permit provider system
    Example: "APPROVED"

  - `country` (string)
    Country code (ISO 3166-1 alpha-3) where the permit applies
    Example: "MLT"

  - `airport` (object)

  - `airport.id` (string)
    Airport identifier
    Example: "123"

  - `airport.name` (string)
    Airport name
    Example: "Vienna International Airport"

  - `airport.icao` (string)
    ICAO code
    Example: "LOWW"

  - `airport.iata` (string)
    IATA code
    Example: "VIE"

  - `issueDate` (string)
    Date and time when the permit was issued
    Example: "2025-01-15T10:30:00.000Z"

  - `document` (object)

  - `document.id` (integer)
    Unique identifier for the document
    Example: 12345

  - `document.uuid` (string)
    Unique identifier for the document file
    Example: "doc-uuid-67890"

  - `document.originalName` (string)
    Original filename of the uploaded document
    Example: "pilot_license.pdf"

  - `document.fileSize` (number)
    Size of the document file in bytes
    Example: 1024000

  - `document.createdAtDateTime` (string)
    Date and time when the document was uploaded
    Example: "2024-01-15T10:30:00.000Z"

  - `document.customName` (string)
    Custom name assigned to the document
    Example: "Captain License"

  - `document.imageSizeX` (number)
    Width of the image in pixels (if applicable)
    Example: 1920

  - `document.imageSizeY` (number)
    Height of the image in pixels (if applicable)
    Example: 1080

  - `document.isThumbnail` (boolean)
    Whether this is a thumbnail version of the document

  - `expirationDate` (string)
    Date and time when the permit expires
    Example: "2025-02-15T23:59:59.000Z"

  - `createdAtDateTime` (string)
    Date and time when the permit was created
    Example: "2025-01-15T10:30:00.000Z"

  - `updatedAtDateTime` (string)
    Date and time when the permit was last updated
    Example: "2025-01-15T10:30:00.000Z"


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 404 fields