---
title: "Get verification"
method: GET
path: "/verifications/{verification_id}"
tags: ["KYC/KYB Verifications"]
---

# Get verification

`GET /verifications/{verification_id}`

Get customer verification result.

## Path parameters

- `verification_id` string, uuid, required

## Response `200`

Verification representation.

- Verification — Verification result.
  - `business_id` string, uuid — Unique ID for the business. Exactly one of `business_id` or `person_id` must be set.
  - `creation_time` string, date-time — The date and time the resource was created.
  - `customer_initiated` boolean — Indicates whether the verification was initiated by the customer.
  - `details` Detail[] — A list of individual checks done as part of the due diligence process for the verification type.
    - `category` 'ADDRESS' | 'BANKRUPTCIES' | 'BUSINESS_NAME' | 'CIP' | 'DEVICE' | 'DOC_DETAILS' | 'DOC_VERIFICATION' | 'EMAIL' | 'FRAUD' | 'LICENSE' | 'OFFICE_ADDRESS' | 'OTHER' | 'PHONE' | 'SELFIE_CAPTURE' | 'SELFIE_DOCUMENT' | 'SOS_DOMESTIC' | 'SOS_FILINGS' | 'SYNTHETIC' | 'TIN_MATCH' | 'WATCHLIST' | 'WEBSITE' — Machine-readable identifier to allow grouping details into subsets. Checks for the following categories should typcially be provided when onboarding personal customers: * `CIP` – Checks relating to a Customer Identification Program (CIP) including name, ID verification, and date of birth. * `ADDRESS` – Address check done either through a bureau or document verification. * `PHONE` – Phone checks, including verifying number and other correlation methods. * `EMAIL` – Email checks, including verifying email address and other correlation methods. * `FRAUD` – Checks relating to elements of fraud. * `SYNTHETIC` – Check relating to elements of synthetic identity. * `DEVICE` – Checks relating to elements of device risk. Can include SDK or IP screening. * `DOC_VERIFICATION` – Document Verification checks, where ID documents are submitted for verification, including liveness test, or other anti-forgery verification. * `SELFIE_CAPTURE` – Selfie capture check, including liveness test, or other anti-fake verification. * `SELFIE_DOCUMENT` – Check if selfie matches with photo on document. * `DOC_DETAILS` – Check if details on ID documents matches with supplied information. * `WATCHLIST` – Outcome from watchlist screenings (especially OFAC/SDN and other sanctions lists). Checks for the following categories should typcially be provided when onboarding businesses customers: * `BUSINESS_NAME` – Business name check done against a bureau. * `OFFICE_ADDRESS` – Address check done either through a bureau or document verification. * `SOS_FILINGS` – Findings from a Secretary of State (SOS) filings check. * `WEBSITE` – Business website check. * `TIN_MATCH` – Taxpayer Identification Number (TIN) check from tax bureau. * `BANKRUPTCIES` – Check for any bankruptcy filings. * `SOS_DOMESTIC` – Outcome from a Domestic Secretary of State (SOS) filings check * `LICENSE` – * `WATCHLIST` – Outcome from watchlist screenings (especially OFAC/SDN and other sanctions lists). If you would like to provide additional information that doesn't fit with an existing category you may provide: * `OTHER` – A category for miscellaneous or uncategorized checks.
    - `description` string — Human-readable description explaining the individual check.
    - `label` string — Human-readable grouping describing the aspect of the customer's identity examined by this check.
    - `result` 'FAIL' | 'INFO' | 'PASS' | 'WARN' — The result of the individual check. One of the following: * `PASS` – the check passed contributing to a positive outcome (or accepted verification result). * `INFO` – the check returned neutral information which may or may not explain a negative result. * `WARN` – the check was inconclusive and might require review. * `FAIL` – the check failed and might result in a failing outcome (or rejected verification_result).
    - `score` number, double — An arbitrary floating point score value which may be used to contextualize the human readable description.
    - `url` string — A URL containing supporting information for this individual check.
    - `vendor_code` string — Machine-readable description of the individual check. This field contains vendor-specific terms and may not be populated in all cases.
  - `id` string, uuid — Unique ID for this verification result.
  - `last_updated_time` string, date-time — The date and time the resource was last updated.
  - `metadata` Metadata — Optional field to store additional information about the resource. Intended to be used by the integrator to store non-sensitive data.
  - `person_id` string, uuid — Unique ID for the person. Exactly one of `person_id` or `business_id` must be set.
  - `result` 'ACCEPTED' | 'PENDING' | 'PROVISIONAL' | 'REJECTED' | 'REVIEW' | 'UNVERIFIED' | 'VENDOR_ERROR', required — The determination of this verification. One of the following: * `UNVERIFIED` – record representing the absence of a verification. * `PENDING` – verification is in progress for this customer. * `PROVISIONAL` – partially verified or verified with restrictions. * `ACCEPTED` – the customer has been verified. * `REVIEW` – verification has run and issues have been identified and require review. * `VENDOR_ERROR` – verification did not successfully run due to an unexpected error or failure. * `REJECTED` – the customer was rejected and should not be allowed to take certain actions e.g., open an account.
  - `vendor_info` union — The information provided to Synctera from the vendor. Interpretation of this object is up to the client.
    - object
      - `content_type` 'application/json', required — Describes the content-type encoding received from the vendor
      - `json` object, required — Data representation in JSON
      - `vendor` string, required
    - object
      - `content_type` 'text/xml', required — Describes the content-type encoding received from the vendor
      - `vendor` string, required
      - `xml` string, required — Data representaion in XML
  - `verification_time` string, date-time, required — The date and time the verification was completed.
  - `verification_type` 'DOCUMENT_VERIFICATION' | 'IDENTITY' | 'LICENSE' | 'MANUAL_REVIEW' | 'RELATED_ENTITIES' | 'WATCHLIST', required — The verification run on the customer. One the following: * `IDENTITY` – verify that the information provided is associated with the identity of a real person or business. * `WATCHLIST` – checks watchlists for known fraud, money laundering, and other suspicious activity. * `DOCUMENT_VERIFICATION` – verifies the authenticity of a document, such as a driver's license, or other government-issued identification document. * `RELATED_ENTITIES` – represents dependent verification checks for related parties (e.g. all beneficial owners must pass KYC for a business to pass KYB). * `MANUAL_REVIEW` – represents the outcome of a manual review of the verification done on a party (note: overrides the outcome of other verification types). * `LICENSE` – represents the outcome of a license verification.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden error
- `404` — Resource not found
- `500` — Internal server error

---

[API](https://skmtc.net/synctera/apis/synctera-api.md) · [All operations](https://skmtc.net/synctera/apis/synctera-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synctera/synctera-api/versions/b0d812e6cdd0/schema)