# Get qualification types

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


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

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


Endpoint: GET /api/external/qualification-types
Version: 1.5.0
Security: API_AUTHENTICATION

## 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: 10

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

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

  - `pagination.filters` (array)

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

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

  - `pagination.filters.value` (string)
    Filter value
    Example: "2024-08-28/2025-02-24"