API reference v2
The ReleasesDates API is a read-only REST API that returns JSON. All requests are made over HTTPS to the base URL below. Dates use ISO 8601; times are in UTC unless a tz parameter is given.
https://releasesdates.com/api/v2
The API is in private beta. Keys are issued after an access request — see Request access.
Authentication
Send your partner token in the Authorization header. Requests without a valid token return 401 unauthorized.
curl https://releasesdates.com/api/v2/releases?category=games \
-H "Authorization: Bearer rd_live_xxxxxxxxxxxxxxxx"
Test keys start with rd_test_ and return the same structure with a limited data set.
Releases
GET /releases
Returns a paginated list of releases, sorted by date.
| Parameter | Type | Description |
|---|---|---|
category | string | films, series, games or software |
region | string | Region code, e.g. eu, us, ru |
from, to | date | Date range, inclusive |
status | string | announced, confirmed, delayed, released |
limit | integer | 1–200, default 50 |
cursor | string | Value of next from the previous page |
{
"items": [
{
"id": "rl_8f2c41d0",
"title": "…",
"category": "series",
"region": "eu",
"date": "2026-12-04",
"precision": "day",
"status": "confirmed",
"platforms": ["streaming"],
"updated_at": "2026-11-17T09:12:44Z"
}
],
"next": "cursor_…"
}
GET /releases/{id}
Returns a single release with all regional dates and its source references.
Changes
GET /changes
Returns date changes (announcements, delays, reschedules) since a given moment. Use it to keep a local copy in sync.
GET /changes?since=2026-11-01T00:00:00Z&category=games
Categories & regions
GET /categories
GET /regions
Reference lists used by the filters above.
Webhooks
Available on Business and Enterprise plans. We send a POST with a JSON body to your endpoint when a release is announced, confirmed or moved. Each request is signed with X-RD-Signature (HMAC-SHA256 of the body with your webhook secret). Failed deliveries are retried for 24 hours.
{ "event": "release.delayed", "release_id": "rl_8f2c41d0",
"old_date": "2026-12-04", "new_date": "2027-02-12",
"occurred_at": "2026-11-17T09:12:44Z" }
Rate limits
| Plan | Requests per day | Burst |
|---|---|---|
| Test key | 500 | 2 / second |
| Starter | 10,000 | 5 / second |
| Business | 250,000 | 20 / second |
| Enterprise | by agreement | by agreement |
Every response includes X-RateLimit-Remaining and X-RateLimit-Reset headers.
Errors
| Status | Code | Meaning |
|---|---|---|
| 400 | bad_request | Invalid parameter value |
| 401 | unauthorized | Missing or invalid token |
| 403 | forbidden | The token has no access to this category or region |
| 404 | not_found | Unknown release ID |
| 429 | rate_limited | Daily or burst limit exceeded |
Questions about the API: partners@releasesdates.com