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

# Get ID Check

> Retrieve one ID check. ID checks are enabled per organization; without them these endpoints return 404 `NOT_FOUND`. Responses never include names, dates of birth, document data or images.

**Required scope:** `id_checks:read`



## OpenAPI

````yaml https://api.ropes.ai/api/docs/openapi.json get /api/public/id-checks/{idCheckId}
openapi: 3.0.0
info:
  title: Ropes Public API
  version: 1.0.0
  description: >-
    Public API for Ropes. Authenticate using your API key in the x-api-key
    header.
servers:
  - url: https://api.ropes.ai
    description: Production server
  - url: http://localhost:3001
    description: Local development server
security: []
paths:
  /api/public/id-checks/{idCheckId}:
    get:
      tags:
        - ID Checks
      summary: Get ID Check
      description: >-
        Retrieve one ID check. ID checks are enabled per organization; without
        them these endpoints return 404 `NOT_FOUND`. Responses never include
        names, dates of birth, document data or images.


        **Required scope:** `id_checks:read`
      parameters:
        - schema:
            type: string
            description: The ID check identifier
          required: true
          description: The ID check identifier
          name: idCheckId
          in: path
      responses:
        '200':
          description: ID check
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdCheck'
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdCheckError'
        '403':
          description: Forbidden - API key is missing the required scope
        '404':
          description: ID check not found, or ID checks not enabled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdCheckError'
        '429':
          description: >-
            Rate limit exceeded - contact support@ropes.ai for further
            assistance.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdCheckError'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdCheckError'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    IdCheck:
      type: object
      properties:
        id:
          type: string
          description: The ID check identifier.
        candidateId:
          type: string
        status:
          type: string
          enum:
            - sent
            - in_progress
            - processing
            - verified
            - failed
            - expired
            - canceled
          description: >-
            sent: emailed, not started. in_progress: the candidate is verifying
            or retrying. processing: awaiting the decision. verified, failed,
            expired and canceled are final.
        failure:
          type: object
          nullable: true
          properties:
            code:
              type: string
              enum:
                - document_expired
                - document_unsupported
                - face_mismatch
                - document_tampered
                - consent_declined
                - other
            reason:
              type: string
              description: Plain-language explanation of the code.
          required:
            - code
            - reason
          description: Why the check or attempt failed. Null unless it failed.
        attemptCount:
          type: integer
          description: Decided verification sessions. Each one is billed.
        maxRetries:
          type: integer
        attempts:
          type: array
          items:
            $ref: '#/components/schemas/IdCheckAttempt'
          description: Verification sessions, oldest first.
        continuity:
          type: object
          nullable: true
          properties:
            verdict:
              type: string
              enum:
                - match
                - mismatch
                - inconclusive
                - not_evaluated
            referenceIsThisCheck:
              type: boolean
              description: True when this check's verified selfie is the reference face.
          required:
            - verdict
            - referenceIsThisCheck
          description: >-
            Face continuity across the candidate's screens, from their latest
            Scout run. Null until Scout has run.
        metadata:
          type: object
          additionalProperties:
            type: string
        createdAt:
          type: string
          format: date-time
        expiresAt:
          type: string
          format: date-time
        completedAt:
          type: string
          nullable: true
          format: date-time
      required:
        - id
        - candidateId
        - status
        - failure
        - attemptCount
        - maxRetries
        - attempts
        - continuity
        - metadata
        - createdAt
        - expiresAt
        - completedAt
    IdCheckError:
      type: object
      properties:
        errorCode:
          type: string
          description: >-
            Machine-readable code: INVALID_REQUEST, INVALID_IDEMPOTENCY_KEY,
            NOT_FOUND, CANDIDATE_NOT_FOUND, CREDIT_LIMIT_REACHED,
            OPEN_ID_CHECK_EXISTS, IDEMPOTENCY_KEY_REUSED,
            CANDIDATE_MISSING_EMAIL, INTERNAL_ERROR.
        message:
          type: string
        idCheckId:
          type: string
          description: The open check, for OPEN_ID_CHECK_EXISTS.
      required:
        - errorCode
        - message
    IdCheckAttempt:
      type: object
      properties:
        status:
          type: string
          enum:
            - in_progress
            - processing
            - verified
            - declined
            - failed
          description: >-
            declined: the attempt failed for a recoverable reason and the
            candidate may retry. failed: it ended the check.
        failure:
          type: object
          nullable: true
          properties:
            code:
              type: string
              enum:
                - document_expired
                - document_unsupported
                - face_mismatch
                - document_tampered
                - consent_declined
                - other
            reason:
              type: string
              description: Plain-language explanation of the code.
          required:
            - code
            - reason
          description: Why the check or attempt failed. Null unless it failed.
        startedAt:
          type: string
          nullable: true
          format: date-time
        submittedAt:
          type: string
          nullable: true
          format: date-time
        decidedAt:
          type: string
          nullable: true
          format: date-time
      required:
        - status
        - failure
        - startedAt
        - submittedAt
        - decidedAt
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Each key carries scopes chosen when it is created: `candidates:read`,
        `candidates:write`, `assessments:read`, `assessments:write`,
        `problems:read`, `problems:write`, `results:read`, `id_checks:read`,
        `id_checks:write`. Keys created before scopes existed have full access.
        A request with a key that lacks an operation's scope returns 403 naming
        the missing scope.

````

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