---
title: "NBI Clearance Verification"
method: POST
path: "/philippines/nbi/verify"
tags: ["NBI Clearance"]
---

# NBI Clearance Verification

`POST /philippines/nbi/verify`

## Request

- Base URL: `https://api.verihubs.com`
- URL: `https://api.verihubs.com/philippines/nbi/verify`
- Auth: none declared. Required headers: `App-ID`, `API-Key`

This method helps you to verify a Philippine National Bureau of Investigation (NBI) clearance number against the legal source.

#### Request Notes
- `clearance_number` is the NBI clearance number, maximum 20 characters, letters, numbers and hyphen only.
- `reference_id` is optional. When it is empty, a UUID is generated and returned in the response. It must be unique per service: reusing a `reference_id` returns `Transaction already created for this reference_id`.

#### Response Notes
`verification_status` returns `VERIFIED` when the clearance is valid, and `REJECTED` when it is expired or not found. The identity data of the clearance holder is returned inside `verification_result` together with `is_valid`.

## Headers

- `App-ID` string, required
- `API-Key` string, required

## Request body

- NBIVerification
  - `clearance_number` string, required: NBI clearance number, maximum 20 characters, letters, numbers and hyphen only.
  - `reference_id` string: Use to indicate your company's transaction (must be unique). When empty, a UUID is generated.

## Response `200`

Successful Response

- ResponseNBIVerification
  - `id` string, required: Verihubs ID, generated string that is unique for every transaction.
  - `reference_id` string, required: Reference id of the transaction, the same value you sent (or a generated UUID if it was empty).
  - `message` string, required: Shows message of the response. Returns `NBI Clearance verification successfully completed` for a verified or expired clearance, and `NBI clearance number not found` when the clearance number is not found.
  - `verification_status` string, required: Verification status of the transaction. Returns `VERIFIED` or `REJECTED`.
  - `verification_result` object: Shows the result of the verification.
    - `full_name` string: Full name as registered on the clearance.
    - `first_name` string
    - `middle_name` string
    - `last_name` string
    - `photo` string: URL of the photo on the clearance.
    - `clearance_expiry` string: Expiry date of the clearance.
    - `occupation` string: Occupation registered on the clearance.
    - `clearance_number` string: Clearance number that was verified.
    - `is_valid` boolean: Returns `true` when the clearance is valid, `false` when it is expired or not found.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/verihubs/apis/philippines-api-documentation.md) - [All operations](https://skmtc.dev/verihubs/apis/philippines-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/verihubs/apis/philippines-api-documentation/revisions/0659a8e15437?raw)