> You are reading the Docusign Developer Documentation. For clean Markdown of any page, append .md to the page URL. > > Documentation indexes by section: > - APIs and SDKs: https://docusign.docs.buildwithfern.com/docs/llms.txt > - Platform 101: https://docusign.docs.buildwithfern.com/platform/llms.txt > - Extension Apps: https://docusign.docs.buildwithfern.com/extension-apps/llms.txt > - Docusign CLI: https://docusign.docs.buildwithfern.com/docusign-cli/llms.txt > > Authentication (OAuth, JWT Grant, M2M): https://docusign.docs.buildwithfern.com/platform/auth > Webhooks and Connect: https://docusign.docs.buildwithfern.com/platform/webhooks > > OpenAPI specifications: https://docusign.docs.buildwithfern.com/openapi.json > MCP server: https://docusign.docs.buildwithfern.com/_mcp/server # Get identity verification workflows GET https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/identity_verification This method returns a list of Identity Verification workflows that are available to an account. **Note:** To use this method, you must either be an account administrator or a sender. ### Related topics - [How to require ID Verification (IDV) for a recipient](/docs/esign-rest-api/how-to/id-verification/) Reference: https://developers.docusign.com/docs/esign-rest-api/reference/accounts/identityverifications/list ## Authentication - `Authorization` header (required) (prefixed with ` Bearer `) — OAuth 2.0 access token (JWT or auth-code grant). Sent as `Authorization: Bearer ` on every request except `GET /v2.1` and `GET /service_information`, which are public discovery endpoints. ## Servers - `https://demo.docusign.net/restapi` (Demo, default) - `https://www.docusign.net/restapi` (Production) ## Request ### Path parameters - `accountId` (string, required) — The external account number (int) or account ID Guid. ### Query parameters - `identity_verification_workflow_status` (string, optional) — Filters the workflows returned according to status. Valid values: - `active`: Only active workflows are returned. This is the default. - `deactivated`: Only deactivated workflows are returned. - `all`: All workflows are returned. ## Response ### 200 Successful response. - `identityVerification` (list of accountIdentityVerificationWorkflow, optional) — Specifies the ID Verification workflow applied on an envelope by workflow ID. See the [list](/docs/esign-rest-api/reference/accounts/identityverifications/list/) method in the [IdentityVerifications](/docs/esign-rest-api/reference/accounts/identityverifications/) resource for more information on how to retrieve workflow IDs available for an account. This can be used in addition to other [recipient authentication](https://support.docusign.com/s/document-item?bundleId=gav1643676262430&topicId=kzp1578456318101.html) methods. Note that ID Verification and ID Check are two distinct methods. ID Verification checks recipients' identity by verifying their ID while ID Check relies on data available on public records (such as current and former address). ## Errors ### 400 Bad Request Error Error encountered. - `errorCode` (string, optional) — The code associated with the error condition. - `message` (string, optional) — A brief message describing the error condition. ## Types ### accountIdentityVerificationWorkflow Specifies an Identity Verification workflow. - `defaultDescription` (string, optional) — Text describing the purpose of the Identity Verification workflow. - `defaultName` (string, optional) — The name of the Identity Verification workflow. - `displayOrder` (string, optional) - `inputOptions` (list of accountIdentityInputOption, optional) - `isDisabled` (string, optional) — When **true,** the workflow is disabled. - `ownerType` (string, optional) - `signatureProvider` (accountSignatureProvider, optional) — Contains information about the signature provider associated with the Identity Verification workflow. If empty, then this specific workflow is not intended for signers. - `steps` (list of accountIdentityVerificationStep, optional) - `workflowId` (string, optional) — Workflow unique IDThis is the ID you must specify when setting ID Verification in an envelope using the `identityVerification` [core recipient parameter](/docs/esign-rest-api/reference/envelopes/enveloperecipients/#core-recipient-parameters) - `workflowLabel` (string, optional) - `workflowResourceKey` (string, optional) — Reserved for Docusign. ### accountIdentityInputOption - `isRequired` (boolean, optional) - `optionName` (string, optional) - `valueType` (string, optional) ### accountSignatureProvider Contains information about the signature provider associated with the Identity Verification workflow. If empty, then this specific workflow is not intended for signers. - `isRequired` (string, optional) — Reserved for Docusign. - `priority` (string, optional) — Reserved for Docusign. - `signatureProviderDisplayName` (string, optional) — Reserved for Docusign. - `signatureProviderId` (string, optional) — Reserved for Docusign. - `signatureProviderName` (string, optional) — The name of an Electronic or Standards Based Signature (digital signature) provider for the signer to use. For details, see [the current provider list](/docs/esign-rest-api/esign101/concepts/standards-based-signatures/). You can also retrieve the list by using the [AccountSignatureProviders: List](/docs/esign-rest-api/reference/accounts/accountsignatureproviders/list/) method. Example: `universalsignaturepen_default` - `signatureProviderOptionsMetadata` (list of accountSignatureProviderOption, optional) — Reserved for Docusign. - `signatureProviderRequiredOptions` (list of signatureProviderRequiredOption, optional) — Reserved for Docusign. ### accountIdentityVerificationStep Information about a specific step in an Identity Verification workflow. - `name` (string, optional) - `type` (string, optional) ### accountSignatureProviderOption Reserved for DocuSign. - `signatureProviderOptionDisplayName` (string, optional) — Reserved for Docusign. - `signatureProviderOptionHintOverrideValue` (string, optional) - `signatureProviderOptionId` (string, optional) — Reserved for Docusign. - `signatureProviderOptionName` (string, optional) — Reserved for Docusign. - `signatureProviderOptionRegexValidationPattern` (string, optional) ### signatureProviderRequiredOption Contains additional information that a specific signature provider requires. - `requiredSignatureProviderOptionIds` (list of string, optional) — Reserved for Docusign. - `signerType` (string, optional) — Reserved for Docusign. ## Examples **Response** ```json { "identityVerification": [ { "defaultDescription": "sample string 1", "defaultName": "sample string 2", "displayOrder": "sample string 3", "inputOptions": [ { "isRequired": true, "optionName": "sample string 1", "valueType": "sample string 2" } ], "isDisabled": "sample string 4", "ownerType": "sample string 5", "signatureProvider": { "isRequired": "sample string 1", "priority": "sample string 2", "signatureProviderDisplayName": "sample string 3", "signatureProviderId": "sample string 4", "signatureProviderName": "sample string 5", "signatureProviderOptionsMetadata": [ { "signatureProviderOptionDisplayName": "sample string 1", "signatureProviderOptionHintOverrideValue": "sample string 2", "signatureProviderOptionId": "sample string 3", "signatureProviderOptionName": "sample string 4", "signatureProviderOptionRegexValidationPattern": "sample string 5" } ], "signatureProviderRequiredOptions": [ { "requiredSignatureProviderOptionIds": [ "sample string 1" ], "signerType": "sample string 1" } ] }, "steps": [ { "name": "sample string 1", "type": "sample string 2" } ], "workflowId": "sample string 6", "workflowLabel": "sample string 7", "workflowResourceKey": "sample string 8" } ] } ```