> ## 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.

# Individual Categorization Hierarchy

> Get available B2C/B2B categories and feature metadata for a tenant

export function RequiredRunnerHeaders() {
  return <>
      <ParamField header="X-Forwarded-For" type="string" required>
        Client source IP (runner default: `127.0.0.1`)
      </ParamField>
      <ParamField header="X-Tenant-ID" type="string" required>
        Tenant identifier
      </ParamField>
      <ParamField header="X-Forwarded-From" type="string" required>
        Client source identifier (runner default: `integration-client`)
      </ParamField>
      <ParamField header="platform" type="string" required>
        Client platform (runner default: `web`)
      </ParamField>
      <ParamField header="deviceId" type="string" required>
        Device identifier (runner default: `integration-device`)
      </ParamField>
      <ParamField header="Authorization" type="string" required>
        Bearer token
      </ParamField>
    </>;
}

# Individual Categorization Hierarchy

Returns customer category options used before registration.

## Endpoint

`GET /api/v2.1/customer/individual/categorization/hierarchy/{tenantId}`

## Path Parameters

<ParamField path="tenantId" type="string" required>
  Tenant UUID. Example: `97e7ff29-15f3-49ef-9681-3bbfcce4f6cd`
</ParamField>

## Required Headers

<RequiredRunnerHeaders />

## Example

```bash cURL theme={null}
curl -X GET "https://sandbox.finhub.cloud/api/v2.1/customer/individual/categorization/hierarchy/97e7ff29-15f3-49ef-9681-3bbfcce4f6cd" \
  -H "X-Tenant-ID: 97e7ff29-15f3-49ef-9681-3bbfcce4f6cd" \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN"
```

## Success Response

```json 200 theme={null}
{
  "code": 200,
  "data": {
    "tenantId": "97e7ff29-15f3-49ef-9681-3bbfcce4f6cd",
    "categories": {
      "INDIVIDUAL_STANDARD": {
        "databaseId": "fs-cat-b2c-low-001",
        "categoryName": "Individual Standard"
      },
      "B2B_SMALL_BUSINESS": {
        "databaseId": "fs-cat-b2b-small-001",
        "categoryName": "Small Business"
      }
    }
  },
  "message": "Success"
}
```

<Note>
  Used by B2C/B2B step runners before registration (Step 2).
</Note>


## OpenAPI

````yaml fincheck.yaml GET /api/v2.1/customer/individual/categorization/hierarchy/{tenantId}
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/individual/categorization/hierarchy/{tenantId}:
    get:
      operationId: getIndividualCategorizationHierarchy
      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'
        - in: path
          name: tenantId
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
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

````