Tickets

Get a ticket category by ID

Retrieves a single ticket category by its unique identifier.

GET

/v2/tickets/categories/{id}

curl --request GET \
  --url https://do.featurebase.app/v2/tickets/categories/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Featurebase-Version: 2026-08-19.orbit'

{
  "access": {
    "adminOnly": false,
    "allowedRoles": [],
    "deniedRoles": [
      "role_blocked"
    ],
    "segments": []
  },
  "createdAt": "2023-12-12T00:00:00.000Z",
  "customFields": [
    "cf_priority",
    "cf_category"
  ],
  "features": {
    "commentsEnabled": true,
    "createdDatesVisible": true,
    "postingEnabled": true
  },
  "icon": {
    "type": "emoji",
    "value": "💡"
  },
  "id": "507f1f77bcf86cd799439011",
  "localization": {
    "description": {
      "en": "Submit and vote on feature ideas"
    },
    "formPlaceholder": {
      "en": "Describe your feature idea..."
    },
    "heroDescription": null,
    "heroTitle": {
      "en": "Share your ideas"
    },
    "name": {
      "en": "Feature Requests",
      "es": "Solicitudes de funciones"
    },
    "submitButtonText": {
      "en": "Submit Feedback"
    }
  },
  "name": "Feature Requests",
  "object": "board",
  "postDefaults": {
    "visibility": "public"
  }
}

Returns the full category object including access controls, feature toggles, and localization settings.

Authorizations

Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

Path Parameters

idstringrequired

Board unique identifier

Example: 507f1f77bcf86cd799439011

Headers

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover

Example: 2026-08-19.orbit

Response

Success

accessobjectrequired

Show child attributes

createdAtstringrequired

ISO 8601 timestamp when created

Example: 2023-12-12T00:00:00.000Z

customFieldsstring[]required

Custom field IDs attached to this board

featuresobjectrequired

Show child attributes

iconobject | nullrequired

The board's icon. Can be one of three types:

emoji: A single emoji character (e.g., 💡, 🚀, ⭐)
icon: A predefined icon from the built-in library (e.g., lightbulb, bug, star)
url: A custom image URL (HTTPS required)

Can be null if no icon is set.

An emoji character as the board icon

Show child attributes

idstringrequired

Unique identifier

Example: 507f1f77bcf86cd799439011

localizationobjectrequired

Show child attributes

namestringrequired

Display name in organization's default locale

Example: Feature Requests

objectenum<string>required

Object type identifier

Available options: board

Example: board

postDefaultsobjectrequired

Show child attributes

Still need help? Ask the team