--- title: "Create validation" method: POST path: "/api/v1/validation" tags: ["Validations"] --- # Create validation `POST /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: (a function with typed inputs; its response is checked against the schema) Use this endpoint to create a new validation for the given account, validation, and associated user details. The following parameters are required request body fields: `account` — Account ID and name. `associated_users` — List of details for each user associated with the validation, including `associate_user_id`, `email`, `phone`, and whether a `new_user` is being created for this validation (default is false). `default_profile_id` — The default credential profile associated with this validation. `validation_entity` — `person` or `organization`. `validation_entity_type` — `account_user`, `end_user`, or `organization`. `validation_method` — `f2f`, `remote`, `RA`, or `manual`. `validation_type` — `advanced+`, `qualified`, or `basic`. `validation_profile_id` — Validation profile ID. ## Request body - ValidationRequest - `account` Account, required - `id` string, required: DigiCert One Account ID - `name` string - `validation_entity` 'person' | 'organization' - `validation_entity_type` 'account_user' | 'end_user' | 'organization' - `validation_type` 'advanced+' | 'qualified' | 'basic' - `validation_method` 'f2f' | 'remote' | 'RA' | 'manual' | 'remote_manual' - `default_profile_id` string, uuid - `associated_users` AssociateUserRequest[], required - `associate_user_id` string - `email` string, required - `phone` string - `new_user` boolean - `language_code` string - `validation_profile_id` string ## Response `201` Validation details - 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)