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

# Events & Tournaments API — GET /v1/events

> Fetch all Valorant in-game events or a single event by UUID. Events are limited-time game modes and seasonal in-game celebrations.

The Events API provides data on Valorant's time-limited in-game events, including seasonal celebrations like Night Market, annual tournaments such as VALORANT Champions, and anniversary activations. Each event entry includes its display name, short name, and start and end timestamps so you can accurately represent event windows in your application.

<Note>
  The `User-Agent` header is required for all requests. Use the format `AppName/Version (+URL)` — for example, `MyApp/1.0 (+https://example.com)`.
</Note>

## Endpoints

| Method | Path                | Description                    |
| ------ | ------------------- | ------------------------------ |
| GET    | `/v1/events`        | Returns all events             |
| GET    | `/v1/events/{uuid}` | Returns a single event by UUID |

***

## GET /v1/events

Returns an array of all Valorant in-game events.

### Request parameters

<ParamField header="User-Agent" type="string" required>
  Identifies your application. Format: `AppName/Version (+URL)`.
</ParamField>

<ParamField query="language" type="string" default="en-US">
  Locale for localized display names. Example: `zh-CN`, `th-TH`.
</ParamField>

### Example request

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url "https://astra.teamfortuna.xyz/v1/events" \
    --header "User-Agent: MyApp/1.0 (+https://example.com)"
  ```

  ```bash cURL with language theme={null}
  curl --request GET \
    --url "https://astra.teamfortuna.xyz/v1/events?language=zh-CN" \
    --header "User-Agent: MyApp/1.0 (+https://example.com)"
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "status": 200,
  "data": [
    {
      "uuid": "68143e6d-473a-0593-22a5-daadbe65807b",
      "displayName": "",
      "shortDisplayName": "",
      "startTime": "2025-01-24T22:00:00Z",
      "endTime": "2025-02-13T22:00:00Z",
      "assetPath": "ShooterGame/Content/Events/2025LNY_Event_Pass/Event_2025LNY_DataAssetV2"
    }
  ]
}
```

***

## GET /v1/events/{uuid}

Returns a single event matching the provided UUID.

### Request parameters

<ParamField path="uuid" type="string" required>
  The UUID of the event to retrieve.
</ParamField>

<ParamField header="User-Agent" type="string" required>
  Identifies your application. Format: `AppName/Version (+URL)`.
</ParamField>

<ParamField query="language" type="string" default="en-US">
  Locale for localized display names.
</ParamField>

### Example request

```bash cURL theme={null}
curl --request GET \
  --url "https://astra.teamfortuna.xyz/v1/events/68143e6d-473a-0593-22a5-daadbe65807b" \
  --header "User-Agent: MyApp/1.0 (+https://example.com)"
```

### Response

```json theme={null}
{
  "status": 200,
  "data": {
    "uuid": "68143e6d-473a-0593-22a5-daadbe65807b",
    "displayName": "",
    "shortDisplayName": "",
    "startTime": "2025-01-24T22:00:00Z",
    "endTime": "2025-02-13T22:00:00Z",
    "assetPath": "ShooterGame/Content/Events/2025LNY_Event_Pass/Event_2025LNY_DataAssetV2"
  }
}
```

***

## Response fields

<ResponseField name="uuid" type="string" required>
  Unique identifier for the event.
</ResponseField>

<ResponseField name="displayName" type="string" required>
  Localized full display name of the event (e.g., `"VALORANT Champions 2024"`).
</ResponseField>

<ResponseField name="shortDisplayName" type="string">
  Abbreviated localized name suitable for compact UI contexts (e.g., `"Champions 2024"`).
</ResponseField>

<ResponseField name="startTime" type="string">
  ISO 8601 UTC timestamp for when the event began (e.g., `"2024-08-01T00:00:00Z"`).
</ResponseField>

<ResponseField name="endTime" type="string">
  ISO 8601 UTC timestamp for when the event ended (e.g., `"2024-08-25T00:00:00Z"`).
</ResponseField>

<ResponseField name="assetPath" type="string">
  Internal Unreal Engine asset path.
</ResponseField>

<Tip>
  Use `startTime` and `endTime` to filter for currently active events by comparing against the current UTC time.
</Tip>