---
descriptions:
  verify_challenge:
    authentication_challenge_id: The unique ID of the authentication Challenge.
    code: The 6 digit code to be verified.
    challenge: 'The relevant [Authentication Challenge](/reference/mfa/challenge).'
    valid: Indicates whether the code was correct.
reference:
  curl:
    - key: verify_challenge
      id: verify_challenge
      url: /reference/mfa/challenge/verify
      title: '/auth/challenges/:id/verify'
      type: POST
      parameters:
        - key: authentication_challenge_id
          type: string
          description: (verify_challenge.authentication_challenge_id)
        - key: code
          type: string
          description: (verify_challenge.code)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: challenge
              type: challenge
              description: (verify_challenge.challenge)
            - key: valid
              type: boolean
              description: (verify_challenge.valid)
  dotnet:
    - key: VerifyChallenge
      id: verify_challenge
      url: /reference/mfa/challenge/verify
      title: mfaService.VerifyChallenge()
      parameters:
        - key: options
          type: VerifyChallengeOptions
          expanded: true
          properties:
            - key: ChallengeId
              type: string
              description: (verify_challenge.authentication_challenge_id)
            - key: Code
              type: string
              description: (verify_challenge.code)
        - (cancellationToken)
      returns:
        - key: Task<VerifyChallengeResponse>
          title: class VerifyChallengeResponse
          expanded: true
          properties:
            - key: Challenge
              type: Challenge
              description: (verify_challenge.challenge)
            - key: Valid
              type: bool
              description: (verify_challenge.valid)
  ruby:
    - key: verify_challenge
      id: verify_challenge
      url: /reference/mfa/challenge/verify
      title: MFA.verify_challenge()
      parameters:
        - key: authentication_challenge_id
          type: String
          description: (verify_challenge.authentication_challenge_id)
        - key: code
          type: String
          description: (verify_challenge.code)
      returns:
        - key: VerifyChallenge
          type: Struct
          unwrap: true
          properties:
            - key: challenge
              type: Challenge
              description: (verify_challenge.challenge)
            - key: valid
              type: bool
              description: (verify_challenge.valid)
  python:
    - key: verify_challenge
      id: verify_challenge
      url: /reference/mfa/challenge/verify
      title: mfa.verify_challenge()
      parameters:
        - key: authentication_challenge_id
          type: str
          description: (verify_challenge.authentication_challenge_id)
        - key: code
          type: str
          description: (verify_challenge.code)
      returns:
        - key: anonymous
          type: dict
          unwrap: true
          properties:
            - key: challenge
              type: authentication_challenge
              description: (verify_challenge.challenge)
            - key: valid
              type: bool
              description: (verify_challenge.valid)
  js:
    - key: verifyChallenge
      id: verify_challenge
      url: /reference/mfa/challenge/verify
      title: mfa.verifyChallenge()
      parameters:
        - key: options
          type: object
          unwrap: true
          properties:
            - key: authenticationChallengeId
              type: string
              description: (verify_challenge.authentication_challenge_id)
            - key: code
              type: string
              description: (verify_challenge.code)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: challenge
              type: Challenge
              description: (verify_challenge.challenge)
            - key: valid
              type: boolean
              description: (verify_challenge.valid)
  php:
    - key: verifyChallenge
      id: verify_challenge
      url: /reference/mfa/challenge/verify
      title: $mfa->verifyChallenge()
      parameters:
        - key: authenticationChallengeId
          type: string
          description: (verify_challenge.authentication_challenge_id)
        - key: code
          type: string
          description: (verify_challenge.code)
      returns:
        - key: anonymous
          type: array
          unwrap: true
          properties:
            - key: challenge
              type: Challenge
              description: (verify_challenge.challenge)
            - key: valid
              type: bool
              description: (verify_challenge.valid)
  java:
    - key: verifyChallenge
      id: verify_challenge
      url: /reference/mfa/challenge/verify
      title: mfa.verifyChallenge()
      parameters:
        - key: options
          type: VerifyChallengeOptions
          expanded: true
          properties:
            - key: authenticationChallengeId
              type: String
              description: (verify_challenge.authentication_challenge_id)
            - key: code
              type: String
              description: (verify_challenge.code)
            - key: builder()
              type: VerifyChallengeOptionsBuilder
              description: (java.builder)
      returns:
        - key: response
          type: VerifyChallengeResponse
          expanded: true
          properties:
            - key: challenge
              type: Challenge
              description: (verify_challenge.challenge)
            - key: valid
              type: Boolean
              description: (verify_challenge.valid)
  go:
    - key: VerifyChallenge
      id: verify_challenge
      url: /reference/mfa/challenge/verify
      title: mfa.VerifyChallenge()
      parameters:
        - (ctx)
        - key: opts
          type: mfa.VerifyChallengeOpts
          expanded: true
          properties:
            - key: ChallengeID
              type: string
              description: (verify_challenge.authentication_challenge_id)
            - key: Code
              type: string
              description: (verify_challenge.code)
      returns:
        - key: verify
          type: mfa.VerifyChallengeResponse
          expanded: true
          properties:
            - key: Challenge
              type: mfa.Challenge
              description: (verify_challenge.challenge)
            - key: Valid
              type: bool
              description: (verify_challenge.valid)
        - (err)
originalPath: .tmp-workos-clone/packages/docs/content/reference/mfa/challenge/verify.mdx
---

## Verify Challenge

Verify Authentication Challenge.

<CodeBlock referenceId="verify_challenge">
  <CodeBlockTab title="Request" file="verify-challenge-request" />
  <CodeBlockTab title="Response" file="verify-challenge-response" />
</CodeBlock>