---
title: "List validations"
method: GET
path: "/api/v1/validation"
tags: ["Validations"]
---

# List validations

`GET /api/v1/validation`

## Request

- Base URL: `https://one.digicert.com/documentmanager`
- URL: `https://one.digicert.com/documentmanager/api/v1/validation`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/digicert/apis/digicert-content-trust-manager/docs/api/v1/validation/get.ts> (a function with typed inputs; its response is checked against the schema)

Use this endpoint to list all validations in your account.

`account_id` must be included as a query tag (add `?account_id={account_id}` to the endpoint URL, replacing `{account_id}` with your account ID).

Results can be filtered using optional search and paging parameters, included as query tags.

## Query parameters

- `account_id` string, required
- `Paging parameters` PagingSortingParams
  - `offset` integer
  - `limit` integer
  - `sort` string[]
- `Search parameters` ValidationSearchParams
  - `id` string
  - `email` string
  - `validation_entity_type` string
  - `validation_type` string
  - `validation_method` 'f2f' | 'remote' | 'RA' | 'manual' | 'remote_manual'
  - `validation_status` 'VALIDATION_CREATED' | 'VALIDATION_ERROR' | 'INVITE_SENT' | 'INVITE_FAILED' | 'PENDING_IDENTITY_PROOFING' | 'APPROVED' | 'REJECTED' | 'ABORTED' | 'DOCUMENT_VERIFICATION_ERROR' | 'REVIEW_PENDING' | 'EXPIRED' | 'PENDING_MANUAL_REVIEW' | 'PENDING_SIGNER_APPROVAL' | 'PENDING_ORG_REVIEW' | 'DISABLED' | 'CANCELLED'
  - `validation_entity` string

## Response `200`

Validations list

- ValidationPaginationResult
  - `total` integer
  - `offset` integer
  - `limit` integer
  - `items` ValidationResponse[]
    - `created_by` string
    - `modified_on` string, date-time
    - `modified_by` string
    - `created_on` string, date-time
    - `validation_id` string
    - `validation_entity` string
    - `validation_entity_type` string
    - `validation_type` string
    - `validation_method` string
    - `validation_status` 'VALIDATION_CREATED' | 'VALIDATION_ERROR' | 'INVITE_SENT' | 'INVITE_FAILED' | 'PENDING_IDENTITY_PROOFING' | 'APPROVED' | 'REJECTED' | 'ABORTED' | 'DOCUMENT_VERIFICATION_ERROR' | 'REVIEW_PENDING' | 'EXPIRED' | 'PENDING_MANUAL_REVIEW' | 'PENDING_SIGNER_APPROVAL' | 'CANCELLED'
    - `default_profile_id` string
    - `credential_profile_ids` string[]
    - `verifyid_transaction_id` string
    - `associated_users` AssociateUserResponse[]
      - `created_by` string
      - `modified_on` string, date-time
      - `modified_by` string
      - `created_on` string, date-time
      - `associate_user_id` string
      - `email` string
      - `phone` string
      - `pending_user_creation` boolean
    - `expiration_date` string, date-time
    - `expired` boolean
    - `rejection_status` string
    - `vetting_details` VettingDetailsResponse
      - `first_name` string
      - `last_name` string
      - `common_name` string
      - `country` string
      - `document_type` 'PASSPORT' | 'DRIVER_LICENSE' | 'ID_CARD'
      - `document_id` string
      - `date_issued` string
      - `valid_until` string
      - `nationality` string
      - `ident_language` string
      - `title` string
      - `organization_uuid` string
      - `organization` string
      - `organization_identifier` string
      - `organization_country` string
      - `organization_unit` string
      - `organization_state` string
      - `organization_locality` string
      - `phone` string
      - `email` string
      - `blocklist_transaction_number` string
      - `partner_id` string
      - `profession_validation_date` string
    - `validation_approvals` ValidationApproval[]
      - `id` string
      - `validationId` string
      - `reviewed_validation_status` 'VALIDATION_CREATED' | 'VALIDATION_ERROR' | 'INVITE_SENT' | 'INVITE_FAILED' | 'PENDING_IDENTITY_PROOFING' | 'APPROVED' | 'REJECTED' | 'ABORTED' | 'DOCUMENT_VERIFICATION_ERROR' | 'EXPIRED' | 'PENDING_MANUAL_REVIEW' | 'PENDING_SIGNER_APPROVAL' | 'PENDING_ORG_REVIEW' | 'DISABLED' | 'CANCELLED'
      - `status` 'APPROVED' | 'REJECTED'
      - `reason` string
      - `reason_code` 'VALIDATION_IN_PROCESS' | 'VALIDATION_COMPLETED'
      - `userId` string
      - `reviewed_on` string, date-time
      - `reviewed_by` string
    - `validation_enrollment_id` string, uuid
    - `validation_profile_id` string, uuid
    - `failure_reason` string
    - `language_code` string
    - `auto_approval_enabled` boolean
    - `terms_and_conditions` string
    - `terms_acceptance_time` string, date-time
    - `client_data` string
    - `last_sent` string, date-time
    - `invites_number` integer
    - `validation_profile` ValidationProfileResponse
      - `id` string, uuid
      - `credential_profile_ids` string[]
      - `default_credential_profile_id` string
      - `validation_method` 'f2f' | 'remote' | 'RA' | 'manual' | 'remote_manual'
      - `validation_type` 'advanced+' | 'qualified' | 'basic'
      - `nickname` string
      - `policies` ValidationProfilePolicyResponse[]
        - `name` 'organization_details_required' | 'title_detail_required' | 'create_user' | 'issue_credential' | 'suppress_validation_approval_email' | 'add_san_value_to_certificate' | 'blocklist_transaction_number_required' | 'allow_opt_out' | 'register_notary_profession_validation' | 'organization_identifier_required'
        - `value` boolean
      - `status` 'ACTIVE' | 'DISABLED'
      - `modified_on` string, date-time
      - `created_by` string
      - `created_on` string, date-time
      - `modified_by` string
      - `account_id` string, uuid
      - `alternative_validation_profile_id` string
      - `is_default_profile` string
      - `organization_id` string
      - `remote_identity_vendor` 'AUTO_IDENT' | 'VIDEO_IDENT'
      - `product_type` string
      - `organization_identifier` string
      - `onboarding_credential_profile_id` string
    - `cancelationReason` string
    - `bulk_onboarding_user_id` string
    - `legal_first_name` string
    - `legal_last_name` string
    - `account_id` string
    - `tags` TagResponse[]
      - `name` string
      - `values` string[]

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/digicert/apis/digicert-content-trust-manager.md) - [All operations](https://skmtc.dev/digicert/apis/digicert-content-trust-manager/llms.txt) - [OpenAPI document](https://skmtc.dev/digicert/apis/digicert-content-trust-manager/revisions/8dec322a0e2b?raw)