# Get qualification types

Retrieves available qualification types and their details for use in crew qualification assignments.

Features:
- Returns paginated list of available qualifications
- Includes qualification metadata and configuration

Example Use Case: An operations manager needs to see all available qualification types in the system to properly assign qualifications to crew members.

For more information on managing crew qualifications, see the Crew Qualification Management Guide.

Endpoint: GET /api/v2/external/qualification-types
Version: 2.4.0
Security: X-Api-Client-Id, X-Auth-Token

## Query parameters:

  - `limit` (integer)
    Maximum number of records to return.
    Example: 20

  - `offset` (integer)
    Number of records to skip before starting to return results.

## Response 200 fields (application/json):

  - `data` (array)
    The list of qualifications for the current page.

  - `data.id` (string)
    Unique identifier for the qualification type
    Example: "qual-type-12345"

  - `data.name` (string)
    Name of the qualification type
    Example: "Airline Transport Pilot License"

  - `data.abbreviation` (string)
    Abbreviated name of the qualification
    Example: "ATPL"

  - `data.warning` (string)
    Warning message associated with the qualification
    Example: "Requires medical certificate"

  - `data.notes` (string)
    Additional notes about the qualification
    Example: "Valid for commercial operations"

  - `data.parentId` (string)
    Identifier of the parent qualification (if applicable)
    Example: "parent-qual-123"

  - `data.appliesTo` (string)
    Specifies which crew positions this qualification applies to
    Enum: "FLIGHT_DECK", "PIC", "SIC", "CREW_CABIN", "CREW_POSITIONS_AND_ROLES"

  - `data.type` (string)
    Type of qualification
    Enum: "LICENSE", "CERTIFICATE", "RATING", "ENDORSEMENT", "TRAINING", "MEDICAL", "OTHER"

  - `data.trainingType` (string)
    Type of training required for this qualification
    Enum: "INITIAL", "RECURRENT", "REFRESHER", "CONVERSION", "OTHER"

  - `data.isActive` (boolean)
    Whether this qualification type is currently active
    Example: true

  - `data.validity` (object)

  - `data.validity.unit` (string)
    Unit of time for validity period
    Enum: "DAYS", "MONTHS", "YEARS"

  - `data.validity.value` (integer)
    Value of the validity period
    Example: 24

  - `data.gracePeriod` (object)

  - `data.gracePeriod.start` (object)

  - `data.gracePeriod.start.type` (string)
    Type of grace period adjustment
    Enum: "DAYS_BEFORE", "DAYS_AFTER", "MONTHS_BEFORE", "MONTHS_AFTER", "YEARS_BEFORE", "YEARS_AFTER"

  - `data.gracePeriod.start.value` (integer)
    Value of the grace period
    Example: 30

  - `data.gracePeriod.end` (object)

  - `data.relations` (array)
    Relations to other entities (aircraft, airports, etc.)

  - `data.relations.type` (string)
    Type of relation
    Enum: "AIRCRAFT", "AIRPORT", "AIRPORT_C", "PILOT_AND_AIRCRAFT"

  - `data.relations.value` (string)
    Value of the relation
    Example: "Boeing 737"

  - `data.alternativeQualificationIds` (array)
    List of alternative qualification IDs
    Example: ["alt-qual-1","alt-qual-2"]

  - `data.createdAtDateTime` (string)
    Date and time when the qualification type was created
    Example: "2024-01-15T10:30:00.000Z"

  - `data.updatedAtDateTime` (string)
    Date and time when the qualification type was last updated
    Example: "2024-01-15T10:30:00.000Z"

  - `pagination` (object)
    Pagination details

  - `pagination.offset` (integer)
    Number of records skipped

  - `pagination.limit` (integer)
    Maximum number of records returned
    Example: 20

  - `pagination.totalItems` (integer)
    Total number of items available
    Example: 150

  - `pagination.sortItems` (array)
    List of fields used for sorting
    Example: ["issueDate desc"]

  - `pagination.filters` (array)
    List of applied filters

  - `pagination.filters.field` (string)
    Field name to filter by
    Example: "issueDate"

  - `pagination.filters.operator` (string)
    Filter operator
    Example: "gte"

  - `pagination.filters.value` (string)
    Filter value
    Example: "2024-01-01T00:00:00.000Z"


## Response 401 fields

## Response 403 fields