Skip to main content
POST
/
api
/
v3
/
verifications
/
kyb
/
ph
/
lite
PH KYB Lite
curl --request POST \
  --url https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/kyb/ph/lite \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "trustValidationId": "{your_trust_validation_id}",
  "trustFlowId": 0,
  "companyName": "<string>",
  "businessIdentificationNumber": "<string>",
  "resultNotificationURL": "https://your-webhook.example.com"
}
'
{
  "success": true,
  "message": "KYB verification processed successfully",
  "data": {
    "companyFound": true
  },
  "verificationStatus": "IN_PROGRESS",
  "verificationStatusCode": 5,
  "trustFlowId": 152,
  "trustValidationId": "d09bacb2-897d-4dff-b48d-19fb048a7891",
  "verificationType": "ph_kyb_lite",
  "metadata": null
}
Run a lightweight Know Your Business verification on a Philippine company. The initial API response acknowledges the request with verificationStatus: IN_PROGRESS; the final result is delivered to the resultNotificationURL you supply, with the same envelope shape and a type field of verification.ph_kyb_lite. Use this endpoint when you only need basic company existence and status information; for shareholder and director records use PH KYB Comprehensive instead.

​
Webhook callback

When the verification completes, IDmeta POSTs the payload below to your resultNotificationURL. The envelope carries type: "verification.ph_kyb_lite", and data.result.CompanyBasicInformation contains the upstream registry record. 
{
  "type": "verification.ph_kyb_lite",
  "success": true,
  "message": "KYB verification completed",
  "data": {
    "companyBasicInformation": {
        "total": 1,
        "data": [
            {
            "companyId": "3073612",
            "address": "NATIONAL",
            "name": {
            "companyName": "PC SQUARE COMPUTER SHOP",
            "isTranslated": false
            },
            "companyStatus": "REGISTERED",
            "businessOwner": "MA. THERESA PADIERNOS TAN",
            "incorpDate": "2021-07-26 00:00:00"
            }
        ]
    }
  },
  "verificationStatus": "VERIFIED",
  "verificationStatusCode": 3,
  "trustFlowId": 152,
  "trustValidationId": "ad2b59c6-2b0b-4a4d-a288-2d7dd29fad1a",
  "verificationType": "ph_kyb_lite",
  "metadata": null
}

Authorizations

​
Authorization
string
header
required

Use Bearer {your_api_token} in the Authorization header.

Headers

​
Accept
string
default:application/json
​
Content-Type
string
default:application/json

Body

application/json

The body is of type any.

Response

200 - application/json

Verification accepted (async). Final result is delivered via webhook.