---
title: "List Verifications"
method: GET
path: "/alpha/verifications"
tags: ["Verification"]
---

# List Verifications

`GET /alpha/verifications`

List verificatins.

## Query parameters

- `size` integer
- `cursor` string
- `verificationId` string
- `finalMatches` boolean
- `startDate` string, date
- `endDate` string, date

## Response `200`

OK

- VerificationListResponse
  - `code` 'OK' | 'CREATED' | 'INVALID_CREDENTIALS' | 'INVALID_PARAMETERS' | 'INVALID_TOKEN' | 'UNAUTHORIZED_ACCESS' | 'MISSING_RESOURCE' | 'REQUEST_LIMIT_EXCEEDED' | 'SERVER_ERROR' | 'UNSUPPORTED_METHOD' | 'SERVER_UNAVAILABLE' | 'TIME_LIMIT_EXCEEDED' — Request status code
  - `message` string — Message response to the request
  - `requestId` string — Unique ID that is added to the body of every response for easy traceability of the request in our logs.
  - `data` object
    - `nextCursor` string — The next cursor value that can be used in the following query.
    - `items` Verification[]
      - `id` string, required — the id of the verification
      - `createdAt` string, date-time, required — Date and time
      - `status` 'PROCESSING' | 'COMPLETED' | 'ERROR', required — the status of the verification
      - `updatedAt` string, date-time, required — Date and time
      - `errorMessage` string — error message when the status is error
      - `requestMeta` VerificationCreateRequest
        - `firstName` string — First Name
        - `middleName` string — Middle Name
        - `lastName` string — Last Name
        - `suffix` string — Suffix
        - `fullName` string — Full Name
        - `additionalData` object
          - `email` string
          - `phone` string
          - `dob` string, date — The date, yyyy-MM-dd
          - `gender` string — Gender
          - `address` string — the address you want to verify
          - `employer` string — employer name
          - `employmentStatus` 'EMPLOYED' | 'UNEMPLOYED' | 'SELF-EMPLOYED' | 'GIG' | 'RETIRED' — employment status
          - `ids` VerificationId[]
            - `idType` 'sss_ph' | 'pagibig_ph' | 'prclicense_ph' | 'tin_ph', required
            - `idSubType` string — If idType = prclicense_ph, subtype should be one of the PrcProfessionEnum value.
            - `idNumber` string, required
        - `consent` Consent, required
          - `type` string — the consent flag key, the consent content should be sent to Smile previously
          - `version` string — the version of this consent
          - `consentedAt` string, date-time, required — Date and time
          - `consentedWith` string, required — The short sentences diplay on the consent page.
          - `consentTemplateId` string — the releated consent template id
      - `result` object
        - `finalMatches` boolean, required — the final match result
        - `names` object, required
          - `firstNameMatches` boolean — first name fuzzy match result. If request without firstName or Smile do not support to match this field, then the value is null.
          - `lastNameMatches` boolean — first name fuzzy match result. If request without lastName or Smile do not support to match this field, then the value is null.
          - `middleNameMatches` boolean — middle name fuzzy match result. If request without middleName or Smile do not support to match this field, then the value is null.
          - `fullNameMatches` boolean — full name fuzzy match result. If request without fullName or Smile do not support to match this field, then the value is null.
        - `additionalData` object
          - `ids` VerificationIdMatchResult[]
            - `idNumber` string, required
            - `idType` string, required
            - `idSubtype` string
            - `matches` boolean, required
          - `dobMatches` boolean — dob full match result. If request without dob or Smile do not support to match this field, then the value is null.
          - `genderMatches` boolean — gender full match result. If request without gender or Smile do not support to match this field, then the value is null.
          - `phoneMatches` VerificationContactMatchResult
            - `value` string — the value of the contact
            - `matches` boolean — Full match result. If request without this field or Smile do not support to match this field, then the value is null.
            - `disposable` boolean — Disposable email/phone. If request without this field or Smile do not support to match this field, then the value is null.
            - `deliverable` boolean — Deliverable email/phone. If request without this field or Smile do not support to match this field, then the value is null.
            - `active` boolean — Active email/phone. If request without this field or Smile do not support to match this field, then the value is null.
            - `provider` string — The provider of the contact
            - `freeProvider` boolean — If the provider is free provider.
          - `emailMatches` VerificationContactMatchResult
            - `value` string — the value of the contact
            - `matches` boolean — Full match result. If request without this field or Smile do not support to match this field, then the value is null.
            - `disposable` boolean — Disposable email/phone. If request without this field or Smile do not support to match this field, then the value is null.
            - `deliverable` boolean — Deliverable email/phone. If request without this field or Smile do not support to match this field, then the value is null.
            - `active` boolean — Active email/phone. If request without this field or Smile do not support to match this field, then the value is null.
            - `provider` string — The provider of the contact
            - `freeProvider` boolean — If the provider is free provider.
          - `addressMatches` boolean — address fuzzy match result. If request without address or Smile do not support to match this field, then the value is null.

## Changes

- **2024-06-27** (v1) `4f4b86b82632` — 4 info
  - added the new optional `query` request parameter `endDate`
  - added the new optional `query` request parameter `finalMatches`
  - added the new optional `query` request parameter `startDate`
  - added the new optional `query` request parameter `verificationId`

[Change history](https://skmtc.dev/smileapi/apis/smile-api/changes/alpha/verifications/get.md)

---

[API](https://skmtc.dev/smileapi/apis/smile-api.md) · [All operations](https://skmtc.dev/smileapi/apis/smile-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smileapi/smile-api/revisions/4f4b86b82632/schema)