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

# List Verifications

> List all verifications with filtering and pagination

# List Verifications

Retrieve a list of all your verifications with optional filtering and pagination.

## Request

### Query Parameters

| Parameter        | Type   | Required | Description                                                                       |
| ---------------- | ------ | -------- | --------------------------------------------------------------------------------- |
| status           | string | No       | Filter by status: `pending`, `submitted`, `action_needed`, `approved`, `rejected` |
| type             | string | No       | Filter by type: `kyc`, `kyb`                                                      |
| subjectReference | string | No       | Search by subject reference                                                       |
| page             | number | No       | Page number (default: 1)                                                          |
| limit            | number | No       | Items per page (default: 20, max: 100)                                            |

## Response

```json theme={null}
{
  "success": true,
  "data": {
    "verifications": [
      {
        "id": "abc123def456",
        "type": "kyc",
        "subjectReference": "user-12345",
        "status": "pending",
        "requestedAt": "2024-01-15T10:30:00.000Z",
        "currentStep": 2,
        "verificationUrl": "https://app.nfi-clear.com/verify/abc123def456"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "totalCount": 150,
      "totalPages": 8,
      "hasMore": true
    }
  }
}
```

## Example

### cURL

```bash theme={null}
curl 'https://clear-api.nfigate.com/api/v1/verifications?status=pending&type=kyc&page=1&limit=20' \
  -H 'X-API-Key: nfi_your_api_key_here'
```

### JavaScript

```javascript theme={null}
const response = await fetch(
  'https://clear-api.nfigate.com/api/v1/verifications?status=pending&page=1',
  {
    headers: { 'X-API-Key': 'nfi_your_api_key_here' }
  }
);

const data = await response.json();
console.log(`Found ${data.data.pagination.totalCount} verifications`);
```

## Filter Examples

```bash theme={null}
# Pending KYC verifications
curl 'https://clear-api.nfigate.com/api/v1/verifications?status=pending&type=kyc' \
  -H 'X-API-Key: nfi_your_api_key_here'

# Search by reference
curl 'https://clear-api.nfigate.com/api/v1/verifications?subjectReference=user-123' \
  -H 'X-API-Key: nfi_your_api_key_here'

# Paginated results
curl 'https://clear-api.nfigate.com/api/v1/verifications?page=2&limit=50' \
  -H 'X-API-Key: nfi_your_api_key_here'
```


## OpenAPI

````yaml GET /verifications
openapi: 3.0.0
info:
  title: NFI Clear API
  description: Identity verification platform for KYC and KYB
  version: 1.0.0
  contact:
    email: support@nfi-clear.com
servers:
  - url: https://clear-api.nfigate.com/api/v1
    description: Production server
security:
  - ApiKeyAuth: []
paths:
  /verifications:
    get:
      summary: List Verifications
      description: List all verifications with filtering and pagination
      operationId: listVerifications
      parameters:
        - name: status
          in: query
          schema:
            type: string
            enum:
              - pending
              - submitted
              - action_needed
              - approved
              - rejected
          description: Filter by status
        - name: type
          in: query
          schema:
            type: string
            enum:
              - kyc
              - kyb
          description: Filter by type
        - name: subjectReference
          in: query
          schema:
            type: string
          description: Search by subject reference
        - name: page
          in: query
          schema:
            type: integer
            default: 1
          description: Page number
        - name: limit
          in: query
          schema:
            type: integer
            default: 20
            maximum: 100
          description: Items per page
      responses:
        '200':
          description: List of verifications
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerificationListResponse'
        '401':
          description: Unauthorized
components:
  schemas:
    VerificationListResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
          properties:
            verifications:
              type: array
              items:
                $ref: '#/components/schemas/Verification'
            pagination:
              type: object
              properties:
                page:
                  type: integer
                limit:
                  type: integer
                totalCount:
                  type: integer
                totalPages:
                  type: integer
                hasMore:
                  type: boolean
    Verification:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          enum:
            - kyc
            - kyb
        subjectReference:
          type: string
        status:
          type: string
          enum:
            - pending
            - submitted
            - action_needed
            - approved
            - rejected
        requestedAt:
          type: string
          format: date-time
        resolvedAt:
          type: string
          format: date-time
          nullable: true
        currentStep:
          type: integer
        verificationUrl:
          type: string
        submittedData:
          type: object
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Your API key from the dashboard

````