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.

ParameterTypeDescription
categorystringfilms, series, games or software
regionstringRegion code, e.g. eu, us, ru
from, todateDate range, inclusive
statusstringannounced, confirmed, delayed, released
limitinteger1–200, default 50
cursorstringValue 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

PlanRequests per dayBurst
Test key5002 / second
Starter10,0005 / second
Business250,00020 / second
Enterpriseby agreementby agreement

Every response includes X-RateLimit-Remaining and X-RateLimit-Reset headers.

Errors

StatusCodeMeaning
400bad_requestInvalid parameter value
401unauthorizedMissing or invalid token
403forbiddenThe token has no access to this category or region
404not_foundUnknown release ID
429rate_limitedDaily or burst limit exceeded

Questions about the API: partners@releasesdates.com