---
title: "Retrieve a season"
method: GET
path: "/season/{season_slug}"
tags: ["Seasons"]
---

# Retrieve a season

`GET /season/{season_slug}`

## Request

- Base URL: `https://api.us.cr4ce.com`
- URL: `https://api.us.cr4ce.com/season/{season_slug}`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/tectonic/apis/award-force-api/docs/season/:season_slug/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the season identified by the specified slug.

## Headers

- `Accept` 'application/vnd.Creative Force.v2.3+json' | 'application/vnd.Creative Force.v2.3+xml', required
- `x-api-language` string[]

## Response `200`

Season retrieved.

- Season
  - `created` string, date-time
  - `name` object: 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.
  - `slug` string
  - `status` 'draft' | 'active' | 'archived' | 'destroyed': Lifecycle status of the season.
  - `updated` string, date-time

## Other responses

- `400`: Request was rejected before the endpoint could process it. Common causes: invalid `Accept` header, unsupported `x-api-language` code, empty request body on `POST` / `PUT`, invalid JSON in the request body, or an invalid slug format in a path parameter.
- `401`: Missing `x-api-key` header.
- `403`: Authenticated request denied. Common causes: invalid or unknown API key, suspended account, or `api` feature not enabled for the account.
- `404`: Resource identified by the path slug does not exist. Returned when the slug is well-formed but no record matches it.
- `429`: Rate limit of 60 requests per minute exceeded.
- `503`: Service is temporarily unavailable due to regional maintenance.

## Changes

- **2026-07-07** (v2) `9b9103538ceb`: 2 info
  - api tag `Seasons` added
  - api tag `Season` removed
- **2026-07-01** (v2) `e96a96d4507e`: 7 info
  - added the media type `application/xml` for the response with the status `200`
  - added the media type `application/xml` for the response with the status `400`
  - added the media type `application/xml` for the response with the status `401`
  - added the media type `application/xml` for the response with the status `403`
  - …3 more

[Operation history](https://skmtc.dev/tectonic/apis/award-force-api/changes/season/:season_slug/get.md)

---

[API](https://skmtc.dev/tectonic/apis/award-force-api.md) - [All operations](https://skmtc.dev/tectonic/apis/award-force-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tectonic/apis/award-force-api/revisions/e2511e46f9f2?raw)