> ## Documentation Index
> Fetch the complete documentation index at: https://docs.idmetagroup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PH KYB Lite

> Lightweight Know Your Business verification for Philippine companies. Asynchronous.

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](/api-reference/know-your-business/philippines/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 your `resultNotificationURL`. The envelope carries `type: "verification.ph_kyb_lite"`, and `data.result.CompanyBasicInformation` contains the upstream registry record.

<CodeGroup>
  ```json VERIFIED theme={null}
  {
    "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
  }
  ```
</CodeGroup>


## OpenAPI

````yaml api-reference/openapi.json POST /api/v3/verifications/kyb/ph/lite
openapi: 3.0.3
info:
  title: IDmeta API
  description: IDmeta verification and integration API.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://{environment-subdomain}.idmetagroup.com
    description: Your environment (replace `{environment-subdomain}`)
    variables:
      environment-subdomain:
        default: integrate
        description: IDmeta environment subdomain
security:
  - bearerAuth: []
tags:
  - name: Processes
    description: Verification process endpoints
  - name: Trust Flow Links
    description: Trust Flow link generation endpoints
  - name: Compliance
    description: Compliance verification endpoints
  - name: Government Data
    description: Government data verification endpoints
  - name: Alternative Verifications
    description: Alternative verification and intelligence endpoints
  - name: OCR
    description: Document OCR extraction endpoints
paths:
  /api/v3/verifications/kyb/ph/lite:
    post:
      tags:
        - KYB
      summary: PH KYB Lite
      description: >-
        Run a lightweight Know Your Business verification on a Philippine
        company. Asynchronous: the API returns IN_PROGRESS and the final result
        is delivered to your `resultNotificationURL` webhook.
      operationId: phKybLiteVerificationV3
      parameters:
        - name: Accept
          in: header
          required: false
          schema:
            type: string
            default: application/json
        - name: Content-Type
          in: header
          required: false
          schema:
            type: string
            default: application/json
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: 4bb91359-f45c-4d50-b64d-9331f75f8665
            examples:
              default:
                summary: PH KYB Lite request
                value:
                  trustValidationId: '{your_trust_validation_id}'
                  trustFlowId: 0
                  companyName: <string>
                  businessIdentificationNumber: <string>
                  resultNotificationURL: https://your-webhook.example.com
      responses:
        '200':
          description: >-
            Verification accepted (async). Final result is delivered via
            webhook.
          content:
            application/json:
              schema:
                $ref: 3004fec3-f592-4168-b2b8-5593590f824d
              example:
                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
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Use `Bearer {your_api_token}` in the Authorization header.

````