---
title: "List credential types"
method: POST
path: "/credentials/v1/credential-types"
tags: ["Credentials"]
---

# List credential types

`POST /credentials/v1/credential-types`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/credentials/v1/credential-types`
- Auth: HTTP bearer

## Request body

- S12UserdocumentsV1ListDocumentTypesRequest
  - `document_category` 'DOCUMENT_CATEGORY_LICENSES_AND_CREDENTIALS': - DOCUMENT_CATEGORY_LICENSES_AND_CREDENTIALS: Licenses and credentials for users
  - `include_global` boolean: Whether to include global types
  - `type_criteria` S12TypefieldV1ListTypesCriteria
    - `filter` S12TypefieldV1ListTypesCriteriaFilter
      - `search` string: Search on a Type's name
      - `category` 'TYPE_CATEGORY_UNSPECIFIED' | 'TYPE_CATEGORY_SYSTEM' | 'TYPE_CATEGORY_CUSTOM': - TYPE_CATEGORY_UNSPECIFIED: Type Unspecified. - TYPE_CATEGORY_SYSTEM: Type pre-defined. - TYPE_CATEGORY_CUSTOM: Type custom.
      - `type_ids` string[]: Search on type's ids
      - `exclude_type_ids` string[]: Type ids to exclude for the response
    - `page_size` integer: Optional. The number of asset types to return. Default of 50.
    - `page_token` string: Optional. If present, then retrieve the next batch of results from the preceding call to this method. `page_token` must be the value of `next_page_token` from the previous response. The values of other method parameters should be identical to those in the previous call. For example: 'ODFBMzQ3MDYtNzQxNy00RDZGLThDNjE1MEFDMkM4MTQ3NDQ='.
    - `sort_field` 'SORT_FIELD_UNSPECIFIED' | 'SORT_FIELD_NAME' | 'SORT_FIELD_CREATED_AT': The options available to sort returned types by. - SORT_FIELD_UNSPECIFIED: `SORT_FIELD_UNSPECIFIED` returns the default sort order. - SORT_FIELD_NAME: `SORT_FIELD_NAME` sorts document types by name. - SORT_FIELD_CREATED_AT: `SORT_FIELD_CREATED_AT` sorts document types by creation time.
    - `sort_direction` 'SORT_DIRECTION_UNSPECIFIED' | 'SORT_DIRECTION_ASC' | 'SORT_DIRECTION_DESC'
    - `include_stats` boolean: Include stats associated with a type.

## Response `200`

A successful response.

- S12UserdocumentsV1ListDocumentTypesResponse
  - `next_page_token` string: If there might be more results than those appearing in this response, then `next_page_token` is included. If empty then there are no more results. To get the next set of results, call this method again using the value of `next_page_token` as `page_token`.
  - `types_list` S12TypefieldV1Type[]: List of types that satisfy filters under current organization.
    - `id` string: A global unique identifier for a type.
    - `name` string: Name of the type.
    - `description` string: Description of the type.
    - `type_category` 'TYPE_CATEGORY_UNSPECIFIED' | 'TYPE_CATEGORY_SYSTEM' | 'TYPE_CATEGORY_CUSTOM': - TYPE_CATEGORY_UNSPECIFIED: Type Unspecified. - TYPE_CATEGORY_SYSTEM: Type pre-defined. - TYPE_CATEGORY_CUSTOM: Type custom.
    - `domain` 'DOMAIN_UNSPECIFIED' | 'DOMAIN_GLOBAL' | 'DOMAIN_ASSETS' | 'DOMAIN_CONTRACTORS' | 'DOMAIN_LICENSES_AND_CREDENTIALS' | 'DOMAIN_TASKS' | 'DOMAIN_USERS' | 'DOMAIN_INVESTIGATIONS' | 'DOMAIN_STRUCTURES' | 'DOMAIN_INTEGRATIONS_HRIS_STAGING' | 'DOMAIN_DOCUMENTS': The domain is used to specify which domain the data is coming from. This allows the shared generic type field service to keep track of which domain owns the data, and enforce any domain-specific access control rules. - DOMAIN_UNSPECIFIED: Domain Unspecified. - DOMAIN_GLOBAL: Owned and managed by system can be used by multiple domains - DOMAIN_ASSETS: Owned and created from Assets domain - DOMAIN_CONTRACTORS: Owned and created from Contractor Management domain - DOMAIN_LICENSES_AND_CREDENTIALS: Owned and created from the Licenses and Credentials domain - DOMAIN_TASKS: Owned and created from the Tasks domain - DOMAIN_USERS: Owned and created from the Users domain - DOMAIN_INVESTIGATIONS: Owned and created from the Investigations domain - DOMAIN_STRUCTURES: Owned and created from the Organisational Structures domain - DOMAIN_INTEGRATIONS_HRIS_STAGING: Owned and created from the Integrations domain - DOMAIN_DOCUMENTS: Owned and created from the Documents service (s12.documents).
    - `stats` S12TypefieldV1TypeStats: Stats associated with a type.
      - `mapping_count` integer: The total number of mappings associated with a type.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `eb6bb843bf18`: 1 warning
  - added the new `DOMAIN_DOCUMENTS` enum value to the `types_list/items/domain/allOf[#/components/schemas/s12.typefield.v1.Domain]/` response property for the response status `200`

[Operation history](https://skmtc.dev/safetyculture/apis/safetyculture-api/changes/credentials/v1/credential-types/post.md)

---

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