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

# Get Categories

> Retrieve all partner categories for organizing partnerships by business type or industry

## Authentication

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://app.journeybee.io/api/v1/categories" \
    -H "Authorization: Bearer your-api-key-uuid" \
    -H "Content-Type: application/json"
  ```
</CodeGroup>

## Response Schema

<ResponseField name="categories" type="array">
  Array of category objects

  <Expandable title="Category Object">
    <ResponseField name="id" type="number">Category ID</ResponseField>
    <ResponseField name="uuid" type="string">Category UUID</ResponseField>
    <ResponseField name="label" type="string">Category name</ResponseField>
    <ResponseField name="partner_type" type="string">Partner type: `referral`, `reseller`</ResponseField>
    <ResponseField name="company_id" type="number">Company ID</ResponseField>
    <ResponseField name="created_at" type="string">Creation timestamp</ResponseField>
    <ResponseField name="updated_at" type="string">Last update timestamp</ResponseField>
  </Expandable>
</ResponseField>

## Example Response

<ResponseExample>
  ```json 200 OK theme={null}
  [
    {
      "id": 1,
      "uuid": "category-uuid-123",
      "label": "Technology",
      "partner_type": "referral",
      "company_id": 123,
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": 2,
      "label": "Healthcare",
      "partner_type": "referral"
    }
  ]
  ```
</ResponseExample>

## Notes

* Requires API key with `read_access` permission
* Categories help organize partners by industry or business type
* Used for filtering and reporting on partnership performance