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

# Get speaker verification

> Returns the speaker verification for a voice



## OpenAPI

````yaml get /organization/voices/{voice_id}/speaker_verification
openapi: 3.0.1
info:
  title: BeyondWords REST API
  description: |-
    This is the documentation for the BeyondWords REST API.
              You can use this API to use BeyondWords programmatically.
              You can get your API Key and Project ID for each project in the Project settings tab in the BeyondWords
              <a href="https://dash.beyondwords.io/dashboard">dashboard</a>.
  version: 1.0.0
servers:
  - url: https://api.beyondwords.io/v1
security: []
paths:
  /organization/voices/{voice_id}/speaker_verification:
    parameters:
      - name: voice_id
        in: path
        required: true
        description: Voice ID
        schema:
          type: string
    get:
      tags:
        - Speaker Verifications
      summary: Show
      description: Returns the speaker verification for a voice
      operationId: organization/voices/speaker_verification#show
      responses:
        '200':
          description: OK
          content:
            application/json:
              examples:
                example:
                  $ref: '#/components/examples/speakerVerificationExample'
              schema:
                $ref: '#/components/schemas/speakerVerificationModel'
        '401':
          description: Invalid authentication token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
      security:
        - apiKey: []
components:
  examples:
    speakerVerificationExample:
      summary: A sample speaker verification response
      value:
        id: 1
        voice_id: 42
        note: Verified by legal team
        consent_statement:
          url: https://example.com/consent.pdf
        created: 2024-01-01 00:00:00 UTC
        updated: 2024-01-01 00:00:05 UTC
  schemas:
    speakerVerificationModel:
      type: object
      properties:
        id:
          type: integer
          description: Unique identifier for the object
        voice_id:
          type: integer
          description: ID of the voice this verification belongs to
        note:
          type: string
          description: Optional note about the verification
          nullable: true
        consent_statement:
          type: object
          description: Consent statement file
          nullable: true
          properties:
            url:
              type: string
              description: URL of the uploaded consent statement file
        created:
          type: string
          description: Time at which the object was created (ISO 8601)
        updated:
          type: string
          description: Time at which the object was updated (ISO 8601)
    errorModel:
      type: object
      properties:
        code:
          type: integer
          description: Error code
        message:
          type: string
          description: Error message
        errors:
          type: array
          nullable: true
          items:
            type: object
            properties:
              location:
                type: string
              message:
                type: string
  securitySchemes:
    apiKey:
      type: apiKey
      name: X-Api-Key
      in: header

````