Retrieve a category

{
  "created": "2025-01-15T09:00:00Z",
  "description": {
    "en_GB": "Submit your documentary films exploring real-world subjects and stories."
  },
  "divisions": 1,
  "form": {
    "slug": "GhIjKlMn",
    "link": "https://api.au.cr4ce.com/form/GhIjKlMn",
    "name": {
      "en_GB": "Application form"
    }
  },
  "name": {
    "en_GB": "Documentary"
  },
  "parent": {
    "slug": "KlMnOpQr",
    "link": "https://api.au.cr4ce.com/category/KlMnOpQr",
    "name": {
      "en_GB": "Film"
    }
  },
  "promoted": null,
  "season": {
    "slug": "QrStUvWx",
    "link": "https://api.au.cr4ce.com/season/QrStUvWx",
    "name": {
      "en_GB": "2025"
    }
  },
  "shortcode": {
    "en_GB": "01"
  },
  "slug": "AbCdEfGh",
  "status": "active",
  "updated": "2025-06-20T14:30:00Z",
  "chapters": [
    {
      "slug": "MnOpQrSt",
      "link": "https://api.au.cr4ce.com/chapter/MnOpQrSt",
      "name": {
        "en_GB": "Film"
      }
    }
  ],
  "applicant_max_applications": null,
  "application_name_label": {
    "en_GB": "Application title"
  },
  "fill_application_name": false,
  "image_heading": {
    "en_GB": "Category image"
  },
  "images": [
    {
      "token": "AbCdEfGhIjKlMnOp",
      "link": "https://api.au.cr4ce.com/file/AbCdEfGhIjKlMnOp",
      "filename": "example.png",
      "download": "https://files.au.cr4ce.com/file/AbCdEfGhIjKlMnOp/example.png?Expires=1781657570&Signature=REDACTED&Key-Pair-Id=REDACTED"
    }
  ],
  "max_image_width": 300,
  "packing_slip_instructions": {
    "en_GB": "Attach this slip to each physical submission."
  },
  "pdf_packing_slip": false
}

{
  "message": "<string>",
  "status_code": 400
}

{
  "message": "<string>",
  "status_code": 401
}

{
  "message": "<string>",
  "status_code": 403
}

{
  "message": "<string>",
  "status_code": 404
}

{
  "message": "<string>",
  "status_code": 429
}

{
  "status": "Maintenance in progress"
}

GET

category

{category_slug}

{
  "created": "2025-01-15T09:00:00Z",
  "description": {
    "en_GB": "Submit your documentary films exploring real-world subjects and stories."
  },
  "divisions": 1,
  "form": {
    "slug": "GhIjKlMn",
    "link": "https://api.au.cr4ce.com/form/GhIjKlMn",
    "name": {
      "en_GB": "Application form"
    }
  },
  "name": {
    "en_GB": "Documentary"
  },
  "parent": {
    "slug": "KlMnOpQr",
    "link": "https://api.au.cr4ce.com/category/KlMnOpQr",
    "name": {
      "en_GB": "Film"
    }
  },
  "promoted": null,
  "season": {
    "slug": "QrStUvWx",
    "link": "https://api.au.cr4ce.com/season/QrStUvWx",
    "name": {
      "en_GB": "2025"
    }
  },
  "shortcode": {
    "en_GB": "01"
  },
  "slug": "AbCdEfGh",
  "status": "active",
  "updated": "2025-06-20T14:30:00Z",
  "chapters": [
    {
      "slug": "MnOpQrSt",
      "link": "https://api.au.cr4ce.com/chapter/MnOpQrSt",
      "name": {
        "en_GB": "Film"
      }
    }
  ],
  "applicant_max_applications": null,
  "application_name_label": {
    "en_GB": "Application title"
  },
  "fill_application_name": false,
  "image_heading": {
    "en_GB": "Category image"
  },
  "images": [
    {
      "token": "AbCdEfGhIjKlMnOp",
      "link": "https://api.au.cr4ce.com/file/AbCdEfGhIjKlMnOp",
      "filename": "example.png",
      "download": "https://files.au.cr4ce.com/file/AbCdEfGhIjKlMnOp/example.png?Expires=1781657570&Signature=REDACTED&Key-Pair-Id=REDACTED"
    }
  ],
  "max_image_width": 300,
  "packing_slip_instructions": {
    "en_GB": "Attach this slip to each physical submission."
  },
  "pdf_packing_slip": false
}

{
  "message": "<string>",
  "status_code": 400
}

{
  "message": "<string>",
  "status_code": 401
}

{
  "message": "<string>",
  "status_code": 403
}

{
  "message": "<string>",
  "status_code": 404
}

{
  "message": "<string>",
  "status_code": 429
}

{
  "status": "Maintenance in progress"
}

The response includes all category fields. Images include a download link.

Authorizations

x-api-key

string

header

required

API key used to authenticate and authorise every request. Include it in the x-api-key header.

Headers

enum<string>

required

Defines the response type.

Available options:

application/vnd.Creative Force.v2.3+json,

application/vnd.Creative Force.v2.3+xml

x-api-language

enum<string>[]

Defines the languages included in the response. If non are provided, the account default language is returned.

Value all overrides any other values present.

You can request multiple languages using a comma-separated string of languages.

The selected language must be supported by your account or a 400 error is returned.

Available options:

all,

ar_AR,

bg_BG,

bn_IN,

ca_ES,

cs_CZ,

cy_GB,

da_DK,

de_DE,

en_GB,

en_US,

el_GR,

es_NN,

es_LA,

et_EE,

fa_NN,

fi_FI,

fr_FR,

fr_CA,

he_IL,

hi_IN,

hr_HR,

hu_HU,

hy_AM,

it_IT,

ja_JP,

ko_KR,

lt_LT,

ms_MY,

nl_NL,

nb_NO,

pl_PL,

pt_BR,

ro_RO,

ru_RU,

sk_SK,

sl_SI,

sq_AL,

sr_RS,

sv_SE,

sw_NN,

th_TH,

tr_TR,

uk_UA,

vi_VN,

zh_CN,

zh_HK

Path Parameters

category_slug

string

required

Slug of the category.

Pattern: ^[A-Za-z]{8}$

Response

Category retrieved.

Grant category that applications are submitted to.

Includes the application form used for submissions, its translated name and description, the season it belongs to, and the rules that govern applications within it. Categories can be nested under a parent category and made available across one or more chapters.

created

string<date-time>

Date and time when the category was created.

description

object

Description shown to applicants on the category, as an HTML fragment.

Map keyed by locale code (for example, en_GB or fr_FR). Keys are drawn from the languages enabled on the account. Values are the translated string.

Show child attributes

divisions

integer

Number of divisions configured for the category. Always at least 1.

Required range: x >= 1

form

object

Application form attached to the category.

Show child attributes

name

object

Display name of the category.

Map keyed by locale code (for example, en_GB or fr_FR). Keys are drawn from the languages enabled on the account. Values are the translated string.

Show child attributes

parent

object | null

Parent category this category sits under.

null for a top-level category.

Show child attributes

promoted

enum<integer> | null

Promotion state of the category.

1 when promoted, 0 when not, and null when no preference has been set.

Available options:

0,

1,

null

season

object

Season the category belongs to.

Show child attributes

shortcode

object

Short code used to reference the category.

Map keyed by locale code (for example, en_GB or fr_FR). Keys are drawn from the languages enabled on the account. Values are the translated string.

Show child attributes

slug

string

Short URL-safe identifier for the category.

status

enum<string>

Current state of the category.

Available options:

active,

inactive

updated

string<date-time>

Date and time when the category was last updated.

chapters

object[]

Chapters the category is available in.

Show child attributes

applicant_max_applications

integer | null

Maximum number of applications a single applicant may submit to this category.

null when the number of applications is not capped.

application_name_label

object

Custom label for the application-name field shown to applicants.

Map keyed by locale code (for example, en_GB or fr_FR). Keys are drawn from the languages enabled on the account. Values are the translated string.

Show child attributes

fill_application_name

boolean

Specifies whether applicants are asked to name their application when submitting to this category.

image_heading

object

Heading shown above the category images.

Map keyed by locale code (for example, en_GB or fr_FR). Keys are drawn from the languages enabled on the account. Values are the translated string.

Show child attributes

images

object[]

Images attached to the category.

Show child attributes

max_image_width

integer

Maximum display width for the category images, in pixels.

packing_slip_instructions

object

Instructions shown on the packing slip for the category.

Map keyed by locale code (for example, en_GB or fr_FR). Keys are drawn from the languages enabled on the account. Values are the translated string.

Show child attributes

pdf_packing_slip

boolean

Specifies whether a PDF packing slip is enabled for the category.

Create a category Update a category

Account

Action tasks

Allocation payments

Allocations

Applications

Applications (realtime)

Assignments

Attachments

Categories

Chapters

Contributors

Documents

Fields

Files

Forms

Funds

Grant statuses

Leaderboard

Rounds

Score sets

Seasons

Taxes

Users

Webhooks

Grant reports

Authorizations

Headers

Path Parameters

Response