> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crossmint.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Identity Verification Status

> Get identity verification status for a user.

**API scope required**: `users.read`



## OpenAPI

````yaml get /2025-06-09/users/{userLocator}/identity-verification
openapi: 3.0.0
info:
  title: Crossmint Users API
  description: Crossmint Users API
  version: 1.0.0
  contact:
    name: Crossmint Support
    url: https://www.crossmint.com
    email: support@crossmint.com
servers:
  - url: https://staging.crossmint.com/api
    description: Staging environment (testnets)
  - url: https://www.crossmint.com/api
    description: Production environment (mainnets)
security: []
tags: []
paths:
  /2025-06-09/users/{userLocator}/identity-verification:
    get:
      tags:
        - Users
      summary: Get Identity Verification Status
      description: |-
        Get identity verification status for a user.

        **API scope required**: `users.read`
      operationId: UsersController-getIdentityVerification-2
      parameters:
        - name: X-API-KEY
          in: header
          description: API key required for authentication
          required: true
          schema:
            type: string
        - name: userLocator
          required: true
          in: path
          schema:
            type: string
      responses:
        '200':
          description: Verification status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdentityVerificationResponseDto'
components:
  schemas:
    IdentityVerificationResponseDto:
      type: object
      properties:
        eligibility:
          type: array
          items:
            type: object
            properties:
              type:
                type: string
                enum:
                  - onramp
                  - onramp-light
                  - offramp
                  - regulated-transfer
                description: Type of verification flow
                example: onramp
              status:
                type: string
                enum:
                  - not-started
                  - requires-data
                  - pending-review
                  - verified
                  - rejected
                  - pending-privacy-policy
                description: Current verification status
                example: requires-data
              missingData:
                type: array
                items:
                  type: string
                  enum:
                    - user-details
                    - kyc-data
                    - verification-history
                    - due-diligence
                  description: Type of missing data required for verification
                  example: user-details
                description: >-
                  List of missing data types required to proceed with
                  verification
                example:
                  - user-details
                  - kyc-data
              missingDocuments:
                type: array
                items:
                  type: string
                  enum:
                    - id
                    - id-back
                    - proof-of-address
                    - proof-of-income
                    - selfie-front
                    - selfie-left
                    - selfie-right
                  description: >-
                    Type of missing document required for verification. Note:
                    selfie-left and selfie-right are optional but highly
                    recommended to increase the chances of successful KYC
                    verification.
                  example: id
                description: >-
                  List of missing documents required to proceed with
                  verification
                example:
                  - id
                  - proof-of-address
            required:
              - type
              - status
            description: Eligibility information for a specific verification type
            example:
              type: onramp
              status: requires-data
              missingData:
                - user-details
                - kyc-data
              missingDocuments:
                - id
                - proof-of-address
          description: Array of eligibility status for different verification types
          example:
            - type: onramp
              status: requires-data
              missingData:
                - user-details
                - kyc-data
              missingDocuments:
                - id
                - proof-of-address
            - type: offramp
              status: verified
            - type: regulated-transfer
              status: pending-review
      required:
        - eligibility
      description: >-
        Response containing identity verification eligibility status for all
        verification types
      example:
        eligibility:
          - type: onramp
            status: requires-data
            missingData:
              - user-details
              - kyc-data
            missingDocuments:
              - id
              - proof-of-address
          - type: offramp
            status: verified
          - type: regulated-transfer
            status: pending-review

````