# Roster Types

Retrieve roster (duty) types that define which fields and behaviors are available when creating or updating a roster assignment. These endpoints provide access to the operator's roster configuration, enabling dynamic UI and validation.

**Business Value**
- Ensure accurate roster data by identifying relevant fields for each duty type.
- Align integration behavior with the operator's specific roster configuration.
- Support dynamic roster interfaces that only display fields enabled for the selected type.
- Streamline the roster management process by reducing validation errors.

<br/>

**Use Cases**
- Retrieve the full list of available roster types and their hierarchical structure.
- Inspect a specific roster type to determine which features (e.g., aircraft, airports, FTL) are enabled.
- Build dynamic forms that adapt based on the chosen roster duty type.

<br/>


## Get roster types

 - [POST /api/v2/roster-types-search](https://developer.fl3xx.com/reference/v2/roster-types/rostertypessearch.md): Returns roster (duty) types with pagination. Each item is simplified; use GET /api/v2/roster-types/{id} for the full type including boolean flags.

Features:
- Filter by native/custom duty types
- Sort results by name
- Pagination support

## Get roster type

 - [GET /api/v2/roster-types/{id}](https://developer.fl3xx.com/reference/v2/roster-types/rostertypebyidget.md): Retrieves full details for a roster type, including all boolean flags that control which fields are enabled for assignments of this type.

Features:
- Returns the complete flag set for a specific duty type
- Use before creating or updating a roster assignment to determine which fields apply