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"
}
'import requests
url = "https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/kyb/ph/lite"
payload = {
"trustValidationId": "{your_trust_validation_id}",
"trustFlowId": 0,
"companyName": "<string>",
"businessIdentificationNumber": "<string>",
"resultNotificationURL": "https://your-webhook.example.com"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
trustValidationId: '{your_trust_validation_id}',
trustFlowId: 0,
companyName: '<string>',
businessIdentificationNumber: '<string>',
resultNotificationURL: 'https://your-webhook.example.com'
})
};
fetch('https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/kyb/ph/lite', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/kyb/ph/lite",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'trustValidationId' => '{your_trust_validation_id}',
'trustFlowId' => 0,
'companyName' => '<string>',
'businessIdentificationNumber' => '<string>',
'resultNotificationURL' => 'https://your-webhook.example.com'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/kyb/ph/lite"
payload := strings.NewReader("{\n \"trustValidationId\": \"{your_trust_validation_id}\",\n \"trustFlowId\": 0,\n \"companyName\": \"<string>\",\n \"businessIdentificationNumber\": \"<string>\",\n \"resultNotificationURL\": \"https://your-webhook.example.com\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/kyb/ph/lite")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"trustValidationId\": \"{your_trust_validation_id}\",\n \"trustFlowId\": 0,\n \"companyName\": \"<string>\",\n \"businessIdentificationNumber\": \"<string>\",\n \"resultNotificationURL\": \"https://your-webhook.example.com\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/kyb/ph/lite")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"trustValidationId\": \"{your_trust_validation_id}\",\n \"trustFlowId\": 0,\n \"companyName\": \"<string>\",\n \"businessIdentificationNumber\": \"<string>\",\n \"resultNotificationURL\": \"https://your-webhook.example.com\"\n}"
response = http.request(request)
puts response.read_body{
"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
}Philippines
PH KYB Lite
Lightweight Know Your Business verification for Philippine companies. Asynchronous.
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"
}
'import requests
url = "https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/kyb/ph/lite"
payload = {
"trustValidationId": "{your_trust_validation_id}",
"trustFlowId": 0,
"companyName": "<string>",
"businessIdentificationNumber": "<string>",
"resultNotificationURL": "https://your-webhook.example.com"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
trustValidationId: '{your_trust_validation_id}',
trustFlowId: 0,
companyName: '<string>',
businessIdentificationNumber: '<string>',
resultNotificationURL: 'https://your-webhook.example.com'
})
};
fetch('https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/kyb/ph/lite', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/kyb/ph/lite",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'trustValidationId' => '{your_trust_validation_id}',
'trustFlowId' => 0,
'companyName' => '<string>',
'businessIdentificationNumber' => '<string>',
'resultNotificationURL' => 'https://your-webhook.example.com'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/kyb/ph/lite"
payload := strings.NewReader("{\n \"trustValidationId\": \"{your_trust_validation_id}\",\n \"trustFlowId\": 0,\n \"companyName\": \"<string>\",\n \"businessIdentificationNumber\": \"<string>\",\n \"resultNotificationURL\": \"https://your-webhook.example.com\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/kyb/ph/lite")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"trustValidationId\": \"{your_trust_validation_id}\",\n \"trustFlowId\": 0,\n \"companyName\": \"<string>\",\n \"businessIdentificationNumber\": \"<string>\",\n \"resultNotificationURL\": \"https://your-webhook.example.com\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/kyb/ph/lite")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"trustValidationId\": \"{your_trust_validation_id}\",\n \"trustFlowId\": 0,\n \"companyName\": \"<string>\",\n \"businessIdentificationNumber\": \"<string>\",\n \"resultNotificationURL\": \"https://your-webhook.example.com\"\n}"
response = http.request(request)
puts response.read_body{
"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.
Data source
Company information is retrieved from the Department of Trade and Industry (DTI).Webhook callback
When the verification completes, IDmeta POSTs the payload below to yourresultNotificationURL. 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
Use Bearer {your_api_token} in the Authorization header.
Body
application/json
The body is of type any.
Response
200 - application/json
Verification accepted (async). Final result is delivered via webhook.
⌘I

