> ## Documentation Index > Fetch the complete documentation index at: https://docs.deepxl.ai/llms.txt > Use this file to discover all available pages before exploring further. # List verification history > List verification history for the organization. Supports sorting, pagination, and tag filtering. ## OpenAPI ````yaml /openapi.json get /v1/verification openapi: 3.1.0 info: title: DeepXL API description: >- Professional document analysis and verification API for fraud detection, identity verification, and data extraction. contact: name: DeepXL Support url: https://deepxl.ai/contact email: hello@deepxl.ai version: 1.1.0 servers: - url: https://api.deepxl.ai description: Production security: [] tags: - name: Fraud Detection description: Detect manipulated or AI-generated content in documents and images. - name: Document Parsing description: Extract structured data from IDs, bank statements, and pay stubs. - name: ID Verification description: Match an ID document against a selfie. - name: File Retrieval description: Fetch original uploads or generated heatmaps from a prior analysis. paths: /v1/verification: get: tags: - ID Verification summary: List verification history description: >- List verification history for the organization. Supports sorting, pagination, and tag filtering. operationId: get_verification_history_v1_verification_get parameters: - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 default: 25 title: Limit - name: offset in: query required: false schema: type: integer minimum: 0 default: 0 title: Offset - name: sortBy in: query required: false schema: type: string default: verificationId title: Sortby - name: direction in: query required: false schema: type: string default: desc title: Direction - name: tagFilter in: query required: false schema: type: string default: '' title: Tagfilter - name: idFileName in: query required: false schema: anyOf: - type: string - type: 'null' title: Idfilename - name: idFileType in: query required: false schema: anyOf: - type: string - type: 'null' title: Idfiletype - name: selfieFileName in: query required: false schema: anyOf: - type: string - type: 'null' title: Selfiefilename - name: selfieFileType in: query required: false schema: anyOf: - type: string - type: 'null' title: Selfiefiletype - name: minIdFileSize in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' title: Minidfilesize - name: maxIdFileSize in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' title: Maxidfilesize - name: minSelfieFileSize in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' title: Minselfiefilesize - name: maxSelfieFileSize in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' title: Maxselfiefilesize - name: verified in: query required: false schema: anyOf: - type: boolean - type: 'null' title: Verified - name: minTimestamp in: query required: false schema: anyOf: - type: integer maximum: 2147483647 minimum: 0 - type: 'null' title: Mintimestamp - name: maxTimestamp in: query required: false schema: anyOf: - type: integer maximum: 2147483647 minimum: 0 - type: 'null' title: Maxtimestamp responses: '200': description: Verification history retrieved successfully content: application/json: schema: $ref: '#/components/schemas/APIVerificationHistoryResponse' example: totalCount: 89 count: 1 data: - verificationId: 456 idFileType: jpeg idFileName: drivers_license.jpg idFileSize: 156789 selfieFileType: jpeg selfieFileName: selfie.jpg selfieFileSize: 89012 model: verification country: us verified: true modelResults: technicalChecks: - type: FACE_MATCH status: PASS confidence: 0.95 details: 'Face match confidence: 95%' - type: LIVENESS status: PASS confidence: 0.98 details: Liveness check passed timestamp: 1725795600 timestampISO: '2024-09-08T10:00:00.000000' tags: - name: customerId value: '9999' - name: customerName value: Acme Corp - name: documentId value: DOC-2024-001 - name: companyName value: DeepXL - name: companyId value: COMP-001 files: - category: id fileName: drivers_license.jpg fileSize: 156789 contentType: image/jpeg timestamp: 1725795600 timestampISO: '2024-09-08T10:00:00.000000' url: >- https://api.deepxl.ai/v1/files/v_id_456_drivers_license.jpg - category: face fileName: selfie.jpg fileSize: 89012 contentType: image/jpeg timestamp: 1725795600 timestampISO: '2024-09-08T10:00:00.000000' url: https://api.deepxl.ai/v1/files/v_face_456_selfie.jpg '400': description: Invalid request parameters (sortBy or direction) '401': description: Authentication required - API key or Clerk token missing/invalid '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '500': description: Internal server error security: - API Key: [] components: schemas: APIVerificationHistoryResponse: properties: totalCount: type: integer title: Totalcount description: Total number of records matching the query count: type: integer title: Count description: Number of records returned in this page data: items: $ref: '#/components/schemas/Verification' type: array title: Data description: List of verification records type: object required: - totalCount - count - data title: APIVerificationHistoryResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError Verification: properties: verificationId: type: integer title: Verificationid description: Unique identifier for the verification record idFileType: type: string title: Idfiletype description: File extension of the ID document (e.g. jpeg, png) idFileName: type: string title: Idfilename description: Original file name of the ID document idFileSize: type: integer title: Idfilesize description: ID document file size in bytes selfieFileType: type: string title: Selfiefiletype description: File extension of the selfie (e.g. jpeg, png) selfieFileName: type: string title: Selfiefilename description: Original file name of the selfie selfieFileSize: type: integer title: Selfiefilesize description: Selfie file size in bytes timestamp: type: integer title: Timestamp description: Unix timestamp of when the verification was performed timestampISO: type: string title: Timestampiso description: ISO 8601 timestamp of when the verification was performed model: type: string title: Model description: Model used for verification modelVersion: anyOf: - type: string - type: 'null' title: Modelversion description: Version of the model used (e.g. 1.0.0) country: anyOf: - type: string - type: 'null' title: Country description: Normalized country hint applied to this verification (us, mx, br) verified: type: boolean title: Verified description: Whether the identity was verified successfully modelResults: additionalProperties: true type: object title: Modelresults description: Technical check results including face match and liveness scores tags: items: $ref: '#/components/schemas/Tag' type: array title: Tags description: Metadata tags attached to this verification default: [] files: items: $ref: '#/components/schemas/FileData' type: array title: Files description: Associated files (ID document and selfie) default: [] type: object required: - verificationId - idFileType - idFileName - idFileSize - selfieFileType - selfieFileName - selfieFileSize - timestamp - timestampISO - model - verified - modelResults title: Verification ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError Tag: properties: name: type: string title: Name description: Tag key name value: type: string title: Value description: Tag value type: object required: - name - value title: Tag FileData: properties: category: anyOf: - type: string - type: 'null' title: Category description: File category (e.g. original_file, heatmap, id, face) fileName: type: string title: Filename description: Name of the file fileSize: type: integer title: Filesize description: File size in bytes contentType: type: string title: Contenttype description: MIME content type (e.g. image/jpeg, application/pdf) timestamp: type: integer title: Timestamp description: Unix timestamp of when the file was created timestampISO: type: string title: Timestampiso description: ISO 8601 timestamp of when the file was created url: anyOf: - type: string - type: 'null' title: Url description: URL to retrieve the file via GET /v1/files/{fileName} type: object required: - fileName - fileSize - contentType - timestamp - timestampISO title: FileData securitySchemes: API Key: type: apiKey description: API key created in the dashboard in: header name: x-api-key ````