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

# Request Email Verification

> Send a 6-digit one-time password to the given email.

Returns 422 `EMAIL_VERIFICATION_NOT_REQUIRED` when you do not require
email verification. Registration then accepts the email without a code,
and that email is not verified.



## OpenAPI

````yaml https://core.prod.gnosispay.com/user-api/openapi.json post /email-verification
openapi: 3.1.0
info:
  title: User Service
  version: 0.0.0
servers:
  - url: https://core.prod.gnosispay.com/user-api
    description: Production
    variables: {}
  - url: https://core.sandbox.gnosispay.in/user-api
    description: Sandbox
    variables: {}
security: []
tags:
  - name: Auth
  - name: User
  - name: Terms
  - name: Source of Funds
  - name: Phone
  - name: User Account
  - name: Cards
  - name: User Movements
  - name: KYC
  - name: PCI
  - name: 3DS
  - name: Health
paths:
  /email-verification:
    post:
      tags:
        - Auth
      summary: Request Email Verification
      description: |-
        Send a 6-digit one-time password to the given email.

        Returns 422 `EMAIL_VERIFICATION_NOT_REQUIRED` when you do not require
        email verification. Registration then accepts the email without a code,
        and that email is not verified.
      operationId: EmailVerification_request
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RequestEmailVerificationRequest'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestEmailVerificationSuccess'
        '400':
          description: Validation failure on email-verification.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmailVerificationValidationError'
        '401':
          description: Access is unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestEmailVerificationUnauthorized'
        '422':
          description: |-
            You do not require email verification. `error` is
            `EMAIL_VERIFICATION_NOT_REQUIRED`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestEmailVerificationUnprocessable'
        '429':
          description: >-
            Send rate limit exceeded. `error` is `OTP_SEND_COOLDOWN` or
            `OTP_SEND_DAILY_CAP`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestEmailVerificationTooManyRequests'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestEmailVerificationInternalError'
        '503':
          description: Service unavailable.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/RequestEmailVerificationServiceUnavailable
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - BearerAuth: []
components:
  schemas:
    RequestEmailVerificationRequest:
      type: object
      required:
        - email
      properties:
        email:
          type: string
          format: email
    RequestEmailVerificationSuccess:
      type: object
      required:
        - ok
      properties:
        ok:
          type: boolean
          enum:
            - true
    EmailVerificationValidationError:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          enum:
            - false
        error:
          $ref: '#/components/schemas/ValidationErrorDetail'
      description: Validation failure on email-verification.
    RequestEmailVerificationUnauthorized:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          enum:
            - false
        error:
          type: string
    RequestEmailVerificationUnprocessable:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          enum:
            - false
        error:
          type: string
      description: |-
        You do not require email verification. `error` is
        `EMAIL_VERIFICATION_NOT_REQUIRED`.
    RequestEmailVerificationTooManyRequests:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          enum:
            - false
        error:
          type: string
      description: >-
        Send rate limit exceeded. `error` is `OTP_SEND_COOLDOWN` or
        `OTP_SEND_DAILY_CAP`.
    RequestEmailVerificationInternalError:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          enum:
            - false
        error:
          type: string
    RequestEmailVerificationServiceUnavailable:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          enum:
            - false
        error:
          type: string
    Error:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          enum:
            - false
        error:
          type: string
    ValidationErrorDetail:
      type: object
      required:
        - name
        - message
      properties:
        name:
          type: string
          enum:
            - ValidationError
        message:
          type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: Bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.