# Get roster type

Retrieves detailed information for a specific roster type by its unique identifier.

Features:
- Returns boolean flags indicating enabled features (aircraft, airports, logbook, FTL, etc.)
- Provides configuration details for specific duty fields
- Supports dynamic UI validation based on the roster type

Example Use Case: Before creating a roster assignment, the system calls this endpoint to check if the chosen duty type requires aircraft and airport information, ensuring only relevant fields are presented to the user.

Endpoint: GET /api/v2/roster-types/{id}
Version: 2.4.0
Security: X-Api-Client-Id, X-Auth-Token

## Path parameters:

  - `id` (string, required)
    Unique identifier of the roster type (same value you use as rosterTypeId in roster assignments).
    Example: "112233"

## Response 200 fields (application/json):

  - `id` (string)
    Unique identifier of the roster type. Use this value as rosterTypeId when creating or updating a roster assignment.
    Example: "112233"

  - `name` (string)
    Short code (e.g. OFF, TRV, FLT) used in grids and exports.
    Example: "OFF"

  - `displayLabel` (string)
    Label shown in the UI.
    Example: "Off"

  - `isNative` (boolean)
    True if this is a system duty kind; false for custom variants.

  - `isCustom` (boolean)
    True if added or customized by the operator.

  - `displayOrder` (integer)
    Sort order in lists and trees.

  - `isHidden` (boolean)
    When true, type is hidden from normal roster UI.

  - `isSubtypeVisible` (boolean)
    When true, roster assignments of this type support Subtype (Early/Late/All Day/Night). Use assignment field dutySubtype.

  - `isAircraftEnabled` (boolean)
    When true, roster assignments of this type support Aircraft. Use assignment object aircraft with aircraftId, crewPositionId (if isCrewPositionVisible), aircraftTypeId (if isAircraftTypeVisible), typeRating (if isTypeRatingVisible), externalAircraftRegistration and engineConfiguration (if isExternalAircraftVisible).

  - `isAircraftTypeVisible` (boolean)
    When true (and isAircraftEnabled), aircraft type (ICAO) is relevant. Use assignment aircraft.aircraftTypeId.

  - `isTypeRatingVisible` (boolean)
    When true (and isAircraftEnabled), type rating is relevant. Use assignment aircraft.typeRating.

  - `isDepartureAirportEnabled` (boolean)
    When true, roster assignments of this type support From airport. Use assignment field departureAirportId.

  - `isArrivalAirportEnabled` (boolean)
    When true, roster assignments of this type support To airport. Use assignment field arrivalAirportId.

  - `isForAirportEnabled` (boolean)
    When true, roster assignments of this type support For airport. Use assignment field serviceAirportId.

  - `isNotesVisible` (boolean)
    When true, roster assignments of this type support Notes. Use assignment field notes.

  - `isAttachmentVisible` (boolean)
    When true, roster assignments of this type support Attachments. Use assignment field travelDocumentIds (on update).

  - `isLandingsVisible` (boolean)
    When true, roster assignments of this type support Logbook landings/takeoffs. Use logbook.dayTakeoffs, logbook.nightTakeoffs, logbook.dayLandings, logbook.nightLandings.

  - `isRoleVisible` (boolean)
    When true, roster assignments of this type support Role (PIC, SIC, etc.). Use assignment field crewRole.

  - `isCrewPositionVisible` (boolean)
    When true (and isAircraftEnabled), crew position on aircraft is relevant. Use assignment aircraft.crewPositionId.

  - `isLocationVisible` (boolean)
    When true, roster assignments of this type support Location airport ("In"). Use assignment field locationAirportId.

  - `isDutyTimeVisible` (boolean)
    When true, roster assignments of this type support Duty time / FTL. Use assignment object ftl (isCountedAsDutyTime, isDutyPeriodStart, isDutyPeriodEnd, isSplitDutyBreakStart, isSplitDutyBreakEnd, dutyTimeMinutes, fdpTimeMinutes, blockTimeMinutes). When isDpTimeEnabled, isFdpTimeVisible, or isBlockTimeVisible are also true, the corresponding manual time fields are supported.

  - `isActualTimeVisible` (boolean)
    When true, roster assignments of this type support Actual start/end time. Use assignment fields actualStartDateTime, actualEndDateTime.

  - `isRelatedBookingVisible` (boolean)
    When true, roster assignments of this type support Related booking. Use assignment field bookingPairing.

  - `isExternalAircraftVisible` (boolean)
    When true (and isAircraftEnabled), roster assignments support External aircraft registration and engine config. Use assignment aircraft.externalAircraftRegistration and aircraft.engineConfiguration.

  - `isFlightTimeVisible` (boolean)
    When true, roster assignments of this type support Flight time (takeoff/landing). Use assignment fields takeoffDateTime, landingDateTime.

  - `isFlightNumberVisible` (boolean)
    When true, roster assignments of this type support Flight number. Use assignment field flightNumber.

  - `isPilotFlightTypeVisible` (boolean)
    When true, roster assignments of this type support Logbook pilot flight type. Use logbook.logbookFlightType.

  - `isOperationalConditionVisible` (boolean)
    When true, roster assignments of this type support Logbook operational condition and type of operation. Use logbook.operationalCondition, logbook.operationType. When duty time is counted and multiple AOCs exist, use logbook.aocId for Operation type (AOC).

  - `isApproachesVisible` (boolean)
    When true, roster assignments of this type support Logbook approaches (precision, non-precision, visual, hold, category). Use logbook.precisionApproaches, logbook.approachCategory, logbook.nonPrecisionApproaches, logbook.isVisualApproach, logbook.isInstrumentHold. For SIM duties, full-motion simulator is in logbook.isFullMotionSimulator.

  - `isDpTimeEnabled` (boolean)
    When true (and isDutyTimeVisible), manual Duty time (minutes) is supported. Use ftl.dutyTimeMinutes.

  - `isFdpTimeVisible` (boolean)
    When true (and isDutyTimeVisible), FDP time (minutes) is supported. Use ftl.fdpTimeMinutes.

  - `isBlockTimeVisible` (boolean)
    When true (and isDutyTimeVisible), Block time (minutes) is supported. Use ftl.blockTimeMinutes.

  - `nestedTypes` (array)
    Child roster types in the tree (same structure recursively).


## Response 401 fields

## Response 403 fields

## Response 404 fields