> ## Documentation Index > Fetch the complete documentation index at: https://docs.beltic.com/llms.txt > Use this file to discover all available pages before exploring further. # List Verifications > Retrieve a paginated list of verifications with optional filters ## OpenAPI ````yaml GET /v1/identity/verifications openapi: 3.1.0 info: title: Beltic Identity API version: 1.0.0 description: >- # Identity API The Beltic Identity API provides identity management capabilities including accounts, sessions, document verification, and identity verifications. ## Key Features - **Account Management**: Create and manage identity accounts - **Session Management**: Create and manage verification sessions with lifecycle controls - **Document Verification**: Submit and process identity documents (government IDs, proof of address) - **Identity Verification**: Run identity, address, and business verifications - **JSON:API Format**: All responses follow JSON:API specification ## Authentication All endpoints require authentication. Include your API key in the `X-Api-Key` header: ``` X-Api-Key: YOUR_API_KEY ``` ## Response Format All responses follow the JSON:API specification for consistent data structures. contact: name: Beltic API Support email: engineering@beltic.com servers: - url: https://api.beltic.com description: Production security: - ApiKeyAuth: [] tags: - name: Accounts description: Account management operations - name: Sessions description: Session management operations - name: Session Devices description: Session device management operations - name: Document Addresses description: Proof of address document management operations - name: Document IDVs description: Government ID verification document management operations - name: Verifications description: Base verification resource operations externalDocs: description: Beltic Platform Documentation url: https://docs.beltic.com paths: /v1/identity/verifications: get: tags: - Verifications summary: List verifications description: Retrieve a paginated list of verifications with optional filters parameters: - schema: type: string enum: - initiated - passed - failed - requires_retry - canceled description: Filter by verification status example: passed required: false description: Filter by verification status name: status in: query - schema: type: string description: Filter by session ID example: 123e4567-e89b-12d3-a456-426614174000 required: false description: Filter by session ID name: session_id in: query - schema: type: string description: Filter verifications created after this date (ISO 8601) example: '2025-01-01T00:00:00.000Z' required: false description: Filter verifications created after this date (ISO 8601) name: created_at_from in: query - schema: type: string description: Filter verifications created before this date (ISO 8601) example: '2025-12-31T23:59:59.999Z' required: false description: Filter verifications created before this date (ISO 8601) name: created_at_to in: query - schema: type: integer minimum: 1 maximum: 100 description: Number of items per page (1-100) example: 15 required: false description: Number of items per page (1-100) name: page[size] in: query - schema: type: string description: Cursor for forward pagination required: false description: Cursor for forward pagination name: page[after] in: query - schema: type: string description: Cursor for backward pagination required: false description: Cursor for backward pagination name: page[before] in: query - schema: type: - boolean - 'null' description: Include total count in response example: true required: false description: Include total count in response name: page[total] in: query responses: '200': description: Verifications retrieved successfully content: application/vnd.api+json: schema: type: object properties: data: type: array items: type: object properties: id: type: string type: type: string enum: - verification attributes: type: object properties: status: type: string enum: - initiated - passed - failed - requires_retry - canceled created_at: type: string submitted_at: type: string completed_at: type: string redacted_at: type: - string - 'null' checks: type: array items: type: object properties: name: type: string status: type: string enum: - not_applicable - passed - failed reasons: type: array items: type: string requirement: type: string enum: - not_required - required - requires_retry metadata: type: object additionalProperties: {} required: - name - status - reasons - requirement - metadata required: - status - created_at - checks relationships: type: object properties: session: type: object properties: data: type: - object - 'null' properties: type: type: string enum: - session id: type: string required: - type - id required: - data required: - session required: - id - type - attributes - relationships meta: type: object properties: page: type: object properties: size: type: number total: type: number hasNext: type: boolean hasPrevious: type: boolean required: - size - hasNext - hasPrevious required: - page links: type: object properties: self: type: string first: type: string last: type: string next: type: string prev: type: string required: - self required: - data - meta - links '500': description: Internal server error content: application/vnd.api+json: schema: type: object properties: errors: type: array items: type: object properties: status: type: string title: type: string detail: type: string required: - status - title - detail required: - errors security: - ApiKeyAuth: [] components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-Api-Key description: |- API key for authentication. Access https://console.beltic.com/ to obtain your API key. ````