---
title: "[beta] Get a list of qualification types."
method: GET
path: "/qualification-types"
tags: ["Beta APIs"]
---

# \[beta\] Get a list of qualification types.

`GET /qualification-types`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/qualification-types`
- Auth: HTTP bearer

Returns a list of qualification types for the specified list of IDs. If no IDs are provided, all qualification types will be returned.

 <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).

To use this endpoint, select **Read Qualification Records** under the Qualification Records category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
 

 **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.

## Query parameters

- `entityType` 'worker' | 'asset', required
- `ids` string[]
- `after` string

## Response `200`

OK response.

- QualificationsGetQualificationTypesResponseBody
  - `data` QualificationTypeResponseObjectResponseBody[], required: List of qualification types.
    - `createdAtTime` string, date-time, required: Creation time of the qualification type. UTC timestamp in RFC 3339 format.
    - `createdBy` FormsPolymorphicUserObjectResponseBody, required: User or driver object.
      - `id` string, required: ID of the polymorphic user.
      - `type` 'driver' | 'user', required: The type of the polymorphic user. Valid values: `driver`, `user`
    - `entityType` 'worker' | 'asset', required: Owner entity type Valid values: `worker`, `asset`
    - `fields` FormsFieldDefinitionObjectResponseBody[], required: List of fields in the qualification type.
      - `allowManualEntry` boolean: Indicates whether the field allows manual entry of a person. Only present for person fields.
      - `allowedAssetTypes` string[]: List of allowed asset types that can be selected for this field. Only present for asset fields.
      - `allowedDateTimeValueType` 'datetime' | 'date' | 'time': Type of date/time entry allowed for this question. Only present for datetime fields. Valid values: `datetime`, `date`, `time`
      - `autofillFromId` string: Identifier of the field that will optionally autofill the current field. Only present for fields that have been configured to be autofilled by a source media field.
      - `columns` FormsTableFieldDefinitionObjectResponseBody[]: List of columns in the table field.
        - `allowManualEntry` boolean: Indicates whether the field allows manual entry of a person. Only present for person fields.
        - `allowedDateTimeValueType` 'datetime' | 'date' | 'time': Type of date/time entry allowed for this question. Only present for datetime fields. Valid values: `datetime`, `date`, `time`
        - `filterByRoleIds` string[]: List of role IDs to filter org users by, representing which roles are selectable people for this field. Only present for person fields.
        - `id` string, uuid, required: Identifier of the field.
        - `includeDrivers` boolean: Indicates whether the field includes drivers as selectable people. Only present for person fields.
        - `includeUsers` boolean: Indicates whether the field includes users as selectable people. Only present for person fields.
        - `label` string, required: Label of the field.
        - `numDecimalPlaces` integer: Number of decimal places allowed. Only present for number fields.
        - `options` FormsSelectOptionObjectResponseBody[]: List of select options for check boxes or multiple choice fields.
          - `id` string, required: Identifier of the option.
          - `ignoreQuestionFromScoreIfSelected` boolean: Indicates whether the question should be ignored from the total score if this option is selected. Returns true if a score weight was not given to this option. Only present when the select form field has scoring.
          - `label` string, required: Label of the option.
          - `optionScoreWeight` integer: Score weight of the option, indicates number of score points received if this option is selected. Only present if the select form field has scoring.
        - `type` 'number' | 'text' | 'multiple_choice' | 'check_boxes' | 'media' | 'datetime' | 'signature' | 'person', required: Type of the field. Valid values: `number`, `text`, `multiple_choice`, `check_boxes`, `media`, `datetime`, `signature`, `person`
      - `conditionalActions` FormsConditionalActionObjectResponseBody[]: List of conditional actions.
        - `actions` FormsActionObjectResponseBody[], required: List of actions to take if the condition is met.
          - `fieldId` string: Identifier of the followup question that will be shown if the condition is met. Only returned when the action type is `askFollowupQuestion`.
          - `sectionId` string: Identifier of the conditional section that will be shown if the condition is met. Only returned when the action type is `showSection`.
          - `type` 'askFollowupQuestion' | 'showSection' | 'requirePhoto' | 'requireNote' | 'createIssue', required: Type of action to take if corresponding condition is met. Valid values: `askFollowupQuestion`, `showSection`, `requirePhoto`, `requireNote`, `createIssue`
        - `condition` FormsConditionObjectResponseBody, required: Forms condition object.
          - `selectedOptionIds` string[]: List of option IDs that will satisfy the condition if selected. For check boxes fields, the condition will be met if any of these option IDs are selected. Only returned for multiple choice or check boxes fields when the condition type is `multipleChoiceValueCondition` or `checkBoxesValueCondition`.
          - `type` 'multipleChoiceValueCondition' | 'checkBoxesValueCondition', required: Type of condition that must be met for actions to be taken. Valid values: `multipleChoiceValueCondition`, `checkBoxesValueCondition`
      - `filterByRoleIds` string[]: List of role IDs to filter org users by, representing which roles are selectable people for this field. Only present for person fields.
      - `id` string, uuid, required: Identifier of the field.
      - `includeDrivers` boolean: Indicates whether the field includes drivers as selectable people. Only present for person fields.
      - `includeUsers` boolean: Indicates whether the field includes users as selectable people. Only present for person fields.
      - `isAutofillSource` boolean: Indicates whether the current field is enabled to autofill other fields. Only present for media fields that have autofill enabled.
      - `isRequired` boolean, required: Indicates whether the form field is required to be filled out by the user.
      - `label` string, required: Label of the field.
      - `numDecimalPlaces` integer: Number of decimal places allowed. Only present for number fields.
      - `options` FormsSelectOptionObjectResponseBody[]: List of select options for check boxes or multiple choice fields.
        - `id` string, required: Identifier of the option.
        - `ignoreQuestionFromScoreIfSelected` boolean: Indicates whether the question should be ignored from the total score if this option is selected. Returns true if a score weight was not given to this option. Only present when the select form field has scoring.
        - `label` string, required: Label of the option.
        - `optionScoreWeight` integer: Score weight of the option, indicates number of score points received if this option is selected. Only present if the select form field has scoring.
      - `questionWeight` integer: The maximum possible score weight for this field. For multiple choice fields, this number is the highest option score weight of the given options. For check boxes fields, this number is the sum of the score weights for all scored options. Only present for multiple choice or check boxes fields that have scoring.
      - `type` 'number' | 'text' | 'multiple_choice' | 'check_boxes' | 'media' | 'datetime' | 'signature' | 'asset' | 'person' | 'geofence' | 'instruction' | 'media_instruction' | 'table' | 'barcode', required: Type of the field. Valid values: `number`, `text`, `multiple_choice`, `check_boxes`, `media`, `datetime`, `signature`, `asset`, `person`, `geofence`, `instruction`, `media_instruction`, `table`, `barcode`
    - `id` string, uuid, required: Unique identifier of the qualification type.
    - `name` string, required: Name of the qualification type.
    - `revisionId` string, uuid, required: Unique identifier of the qualification type revision.
    - `updatedAtTime` string, date-time, required: Update time of the qualification type. UTC timestamp in RFC 3339 format.
    - `updatedBy` FormsPolymorphicUserObjectResponseBody, required: User or driver object.
      - `id` string, required: ID of the polymorphic user.
      - `type` 'driver' | 'user', required: The type of the polymorphic user. Valid values: `driver`, `user`
  - `pagination` GoaPaginationResponseResponseBody, required: Pagination parameters.
    - `endCursor` string, required: Cursor identifier representing the last element in the response. This value should be used in conjunction with a subsequent request's 'after' query parameter. This may be an empty string if there are no more pages left to view.
    - `hasNextPage` boolean, required: True if there are more pages of results immediately available after this endCursor.

## Other responses

- `401`: Unauthorized response.
- `404`: Not Found response.
- `405`: Method Not Allowed response.
- `413`: Content Too Large response.
- `429`: Too Many Requests response.
- `500`: Internal Server Error response.
- `501`: Not Implemented response.
- `502`: Bad Gateway response.
- `503`: Service Unavailable response.
- `504`: Gateway Timeout response.
- `default`: Bad Request response.

---

[API](https://skmtc.dev/samsara/apis/samsara-api.md) - [All operations](https://skmtc.dev/samsara/apis/samsara-api/llms.txt) - [OpenAPI document](https://skmtc.dev/samsara/apis/samsara-api/revisions/a9e35d4999be?raw)