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

# Get verification

> Returns a mobile SDK verification and each platform's status and result: the same data as its `platform.finished` and `verification.finished` webhooks. A Development API key fetches test verifications, and a Production API key live ones. The response is the object itself, not inside the `status`/`data` envelope. See [Verifications](/api-reference/verifications).



## OpenAPI

````yaml /api-reference/openapi.json get /partner/verifications/{id}
openapi: 3.1.0
info:
  title: Cr3dentials Partner API
  description: >-
    Integrate account verification into your application. Users verify their
    accounts through an iframe-based browser session, and you receive
    cryptographically attested proof of data authenticity.
  version: 1.0.0
  contact:
    name: Cr3dentials Support
    url: https://cr3dentials.xyz
servers:
  - url: https://app.cr3dentials.xyz/v1
    description: Production
  - url: https://staging.cr3dentials.xyz/v1
    description: Staging
security:
  - apiKey: []
paths:
  /partner/verifications/{id}:
    get:
      tags:
        - Verifications
      summary: Get verification
      description: >-
        Returns a mobile SDK verification and each platform's status and result:
        the same data as its `platform.finished` and `verification.finished`
        webhooks. A Development API key fetches test verifications, and a
        Production API key live ones. The response is the object itself, not
        inside the `status`/`data` envelope. See
        [Verifications](/api-reference/verifications).
      operationId: getVerification
      parameters:
        - name: id
          in: path
          required: true
          description: >-
            The `verificationId`, from a webhook or from the app's
            `VerifyOutcome`.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: The verification
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Verification'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: >-
            No such verification for your team, or it doesn't match your API
            key's environment.
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  schemas:
    Verification:
      type: object
      properties:
        verificationId:
          type: string
          format: uuid
          example: 7d0f3c52-9a41-4b8e-b6f2-2f1d9c6e0a17
        test:
          type: boolean
          description: '`true` for a verification started with a test key.'
          example: true
        reference:
          type: string
          description: Your reference.
          example: order_8f3k2
        createdAt:
          type: string
          format: date-time
        finishedAt:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            When every platform had ended and `verification.finished` was queued
            for your webhooks. `null` until then.
        platforms:
          type: array
          description: One entry per platform, in the order the app passed them.
          items:
            $ref: '#/components/schemas/VerificationPlatform'
    VerificationPlatform:
      type: object
      properties:
        platform:
          type: string
          example: zktls-demo
        runId:
          type: string
          format: uuid
          description: This platform's run, as in its `platform.finished` webhook.
        status:
          type: string
          enum:
            - pending
            - done
            - failed
            - not_started
          description: >-
            `pending` until the run has ended and its `platform.finished`
            webhook is on its way: the user is on it, or its result is on the
            way or still being checked. Then `done` or `failed`. A platform the
            user never started reads `not_started` once the app, or the 2-hour
            expiry, ends it.
        complete:
          type:
            - boolean
            - 'null'
          description: >-
            `true` when the platform's read was complete, `false` when a size
            cap ended it first. `null` unless `status` is `done`.
        result:
          type:
            - object
            - 'null'
          description: The platform's attested figures. `null` unless `status` is `done`.
          additionalProperties: true
        claim:
          type:
            - string
            - 'null'
          description: The attester's signed claim, in base64.
        error:
          type:
            - object
            - 'null'
          description: 'When the run failed: its error code and message.'
          properties:
            code:
              type: string
              example: no_result
            message:
              type: string
        finishedAt:
          type:
            - string
            - 'null'
          format: date-time
          description: When the run ended.
  responses:
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/json:
          example:
            statusCode: 401
            message: Unauthorized
    RateLimited:
      description: Too many requests — 120 req / 60s per API key. Use exponential backoff.
      content:
        application/json:
          example:
            statusCode: 429
            message: Too Many Requests
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Your partner API key (starts with `cr3d_`). Send it only in the
        `x-api-key` header, never as `Authorization: Bearer`. Keep it on your
        server.

````

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