Business Categories

Overview

The getBusinessCategories query returns every active business category with its sub-categories. Both IDs are required by registerBusiness, and a sub-category is only valid alongside the category it belongs to. Let the user pick a category and one of that category’s sub-categories in your UI, then pass both UUIDs through.

Do not hardcode these UUIDs. Only currently-active categories are returned, the list differs between environments, and it changes over time. Fetch at runtime — a sub-category from a different category is rejected at registration with BS-0006.

Required scopes

Property	Value
Endpoint	GraphQL API
Authentication	OAuth Bearer Token, account type `CONSUMER`
Required Scopes	`REGISTER_BUSINESS`

Use the same consumer token you will use for registerBusiness. A business-account token is rejected, and Basic authentication is not accepted.

Basic query structure

query GetBusinessCategories {
  getBusinessCategories {
    businessCategoryId
    categoryName
    categoryDescription
    businessSubCategories {
      businessSubCategoryId
      subCategoryName
    }
  }
}

This query takes no arguments.

Response details

Field	Type	Description
`businessCategoryId`	`UUID`	Category ID — pass as `businessCategoryId` on `registerBusiness`
`categoryName`	`String`	Category display name
`categoryDescription`	`String`	Category description. May be `null`
`businessSubCategories`	`[BusinessSubCategory]`	Sub-categories that belong to this category

BusinessSubCategory

Field	Type	Description
`businessSubCategoryId`	`UUID`	Sub-category ID — pass as `businessSubCategoryId` on `registerBusiness`
`subCategoryName`	`String`	Sub-category display name

Categories are returned sorted by categoryName, ascending.

cURL Example

curl -X POST https://transactional-graph.staging.fluzapp.com/api/v1/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "query": "query GetBusinessCategories { getBusinessCategories { businessCategoryId categoryName categoryDescription businessSubCategories { businessSubCategoryId subCategoryName } } }"
  }'

Example Response

{
  "data": {
    "getBusinessCategories": [
      {
        "businessCategoryId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "categoryName": "Technology",
        "categoryDescription": "Software and IT services",
        "businessSubCategories": [
          {
            "businessSubCategoryId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
            "subCategoryName": "SaaS"
          }
        ]
      }
    ]
  }
}

Error Codes

This query returns all failures in the top-level errors array — there is no success: false payload.

Code	Name	Description	How to resolve
`AUTH-0002`	InvalidCredentials	Basic auth was used, or the token’s account type is not `CONSUMER`	Use a consumer-account Bearer token
`AUTH-0031`	InvalidScope	The token is missing the `REGISTER_BUSINESS` scope	Add the scope in Application Scopes and re-mint the token
`G-0001`	InternalError	Internal error while reading categories	Retry once. If it persists, contact support with the timestamp

Notes

Categories a user selects here are read by a human reviewer during KYB, so surface categoryDescription in your UI where it helps them choose accurately.
Sending one ID without the other is rejected at registration with ARG-0002. Always pass both.

KYB overview

Prerequisites and the end-to-end registration flow.

Register a business

The mutation that consumes these IDs.

​Overview

​Required scopes

​Basic query structure

​Response details

​BusinessSubCategory

​cURL Example

​Example Response

​Error Codes

​Notes

​Related pages

KYB overview

Register a business

Overview

Required scopes

Basic query structure

Response details

BusinessSubCategory

cURL Example

Example Response

Error Codes

Notes

Related pages