# Get all active business unit types

Endpoint: GET /v1/{countryCode}/business-unit-types
Version: 0.0.1
Security: jwt-authorizer

## Path parameters:

  - `countryCode` (string, required)
    Enum: "au", "nz"

## Response 200 fields (application/json):

  - `businessUnitTypes` (array, required)
    List of all active business unit types for the organisation.

  - `businessUnitTypes.id` (integer, required)
    Unique numeric identifier for the business unit type.
    Example: 1

  - `businessUnitTypes.code` (string, required)
    Short code identifying the business unit type.
    Example: "B"

  - `businessUnitTypes.description` (string, required)
    Human-readable name for the business unit type.
    Example: "Branch"

  - `businessUnitTypes.enabled` (boolean, required)
    Whether this business unit type is currently active.
    Example: true

  - `businessUnitTypes.dateDisabled` (string)
    Date this type was disabled.
    Example: "2024-03-01"

## Response 400 fields (application/json):

  - `errorCode` (string, required)
    Stable machine-readable error identifier (UPPERCASE_WITH_UNDERSCORES).
    Example: "RESOURCE_NOT_FOUND"

  - `message` (string, required)
    Human-readable error description.
    Example: "The requested resource was not found."

  - `timestamp` (string)
    Time at which the error occurred (ISO 8601).
    Example: "2026-06-04T10:15:30Z"

  - `status` (integer)
    HTTP status code.
    Example: 404

  - `instance` (string)
    The request path or resource identifier that triggered the error.
    Example: "/v1/au/branches/MEL01"

  - `details` (array, required)
    Structured validation error details (populated for 400 responses).

  - `details.field` (string)
    The field that failed validation.
    Example: "typeCodes"

  - `details.issue` (string)
    Description of the validation failure.
    Example: "Invalid branch type code value."

## Response 401 fields (application/json):

  - `errorCode` (string, required)
    Stable machine-readable error identifier (UPPERCASE_WITH_UNDERSCORES).
    Example: "RESOURCE_NOT_FOUND"

  - `message` (string, required)
    Human-readable error description.
    Example: "The requested resource was not found."

  - `timestamp` (string)
    Time at which the error occurred (ISO 8601).
    Example: "2026-06-04T10:15:30Z"

  - `status` (integer)
    HTTP status code.
    Example: 404

  - `instance` (string)
    The request path or resource identifier that triggered the error.
    Example: "/v1/au/branches/MEL01"

  - `details` (array)
    Structured validation error details (populated for 400 responses).


