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

# Organization Verify (KYB Initiation)

> Initiate KYB verification for an organization

export function RequiredRunnerHeadersWithUserContext() {
  return <>
      <RequiredRunnerHeaders />
      <ParamField header="X-User-ID" type="string" required>
        User executing privileged organization action
      </ParamField>
      <ParamField header="X-User-Roles" type="string" required>
        Comma-separated roles (example: `ADMIN_USER,COMPLIANCE_OFFICER`)
      </ParamField>
    </>;
}

# Organization Verify (KYB Initiation)

Starts a business verification flow using `BUSINESS_VERIFICATION` and `TENANT_VERIFIED`.

## Endpoint

`POST /api/v2.1/customer/organization/{organizationId}/verify`

## Required Headers

<RequiredRunnerHeadersWithUserContext />

## Request Example

```json theme={null}
{
  "customerId": "f458d016-56bb-43a6-856c-4d0456b2c38c",
  "type": "BUSINESS_VERIFICATION",
  "requestedLevel": "TENANT_VERIFIED",
  "requestedByUserId": "da9a15d2-1eb9-4804-a812-b58b03f33018",
  "requestedByTenantId": "97e7ff29-15f3-49ef-9681-3bbfcce4f6cd",
  "notes": "Business Verification"
}
```

## Success Response

```json 200 theme={null}
{
  "code": 200,
  "data": {
    "verificationId": "ac0d408e-06b8-420c-9876-745db4ea4c98",
    "status": "PENDING",
    "verificationType": "KYB"
  },
  "message": "Success"
}
```

<Note>
  Used in B2B flow Step 6 (with fallback to `POST /api/v2.1/verifications`).
</Note>


## OpenAPI

````yaml fincheck.yaml POST /api/v2.1/customer/organization/{organizationId}/verify
openapi: 3.0.3
info:
  title: Fincheck Endpoint Set
  version: 1.1.0
  description: |
    Focused API spec for Customer APIs and Verification & Compliance endpoints,
    aligned to business-bff B2C/B2B runners and dump payloads.
servers:
  - url: https://sandbox.finhub.cloud
security: []
paths:
  /api/v2.1/customer/organization/{organizationId}/verify:
    post:
      operationId: verifyOrganization
      parameters:
        - $ref: '#/components/parameters/XForwardedFor'
        - $ref: '#/components/parameters/XTenantId'
        - $ref: '#/components/parameters/XForwardedFrom'
        - $ref: '#/components/parameters/Platform'
        - $ref: '#/components/parameters/DeviceId'
        - $ref: '#/components/parameters/Authorization'
        - $ref: '#/components/parameters/XUserId'
        - $ref: '#/components/parameters/XUserRoles'
        - in: path
          name: organizationId
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateVerification'
      responses:
        '200':
          description: Verification initiated
components:
  parameters:
    XForwardedFor:
      in: header
      name: X-Forwarded-For
      required: true
      schema:
        type: string
      example: 127.0.0.1
    XTenantId:
      in: header
      name: X-Tenant-ID
      required: true
      schema:
        type: string
      example: 97e7ff29-15f3-49ef-9681-3bbfcce4f6cd
    XForwardedFrom:
      in: header
      name: X-Forwarded-From
      required: true
      schema:
        type: string
      example: integration-client
    Platform:
      in: header
      name: platform
      required: true
      schema:
        type: string
      example: web
    DeviceId:
      in: header
      name: deviceId
      required: true
      schema:
        type: string
      example: integration-device
    Authorization:
      in: header
      name: Authorization
      required: true
      schema:
        type: string
      example: Bearer YOUR_ACCESS_TOKEN
    XUserId:
      in: header
      name: X-User-ID
      required: true
      schema:
        type: string
      example: da9a15d2-1eb9-4804-a812-b58b03f33018
    XUserRoles:
      in: header
      name: X-User-Roles
      required: true
      schema:
        type: string
      example: ADMIN_USER,COMPLIANCE_OFFICER
  schemas:
    CreateVerification:
      type: object
      required:
        - customerId
        - type
        - requestedLevel
        - requestedByUserId
        - requestedByTenantId
        - notes
      properties:
        customerId:
          type: string
          example: 2dac1793-ab48-420c-b0b5-01292302e188
        type:
          type: string
          example: IDENTITY_VERIFICATION
        requestedLevel:
          type: string
          example: TENANT_VERIFIED
        requestedByUserId:
          type: string
          example: 0d488f57-57ef-4f9a-88a6-f89121cab838
        requestedByTenantId:
          type: string
          example: 97e7ff29-15f3-49ef-9681-3bbfcce4f6cd
        notes:
          type: string
          example: Identity Verification
      example:
        customerId: 2dac1793-ab48-420c-b0b5-01292302e188
        type: IDENTITY_VERIFICATION
        requestedLevel: TENANT_VERIFIED
        requestedByUserId: 0d488f57-57ef-4f9a-88a6-f89121cab838
        requestedByTenantId: 97e7ff29-15f3-49ef-9681-3bbfcce4f6cd
        notes: Identity Verification

````