---
title: "Changes to Get song ranking for a date"
method: GET
path: "/api/v2.14/chart/song/{slug}/ranking/{datetime}"
---

# Changes to Get song ranking for a date

`GET /api/v2.14/chart/song/{slug}/ranking/{datetime}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 8 revisions.

- **2026-11-10** `0d77a777541f`: 27 breaking, 12 info
- **2026-11-10** `001f23a14a51`: 3 breaking, 39 info

## Changes

- **2026-11-10** `0d77a777541f`: 27 breaking, 12 info
  - the response property `errors` became optional for the status `200`
  - the response property `items/items/entryState` became optional for the status `200`
  - the response property `items/items/oldPosition` became optional for the status `200`
  - the response property `items/items/position` became optional for the status `200`
  - the response property `items/items/positionEvolution` became optional for the status `200`
  - the response property `items/items/rankDate` became optional for the status `200`
  - the response property `items/items/song` became optional for the status `200`
  - the response property `items/items/timeOnChart` became optional for the status `200`
  - the response property `items/items/timeOnChartUnit` became optional for the status `200`
  - the response property `page` became optional for the status `200`
  - the response property `page/limit` became optional for the status `200`
  - the response property `page/next` became optional for the status `200`
  - the response property `page/offset` became optional for the status `200`
  - the response property `page/previous` became optional for the status `200`
  - the response property `related` became optional for the status `200`
  - the response property `related/chart` became optional for the status `200`
  - the response property `related/chart/cityName` became optional for the status `200`
  - the response property `related/chart/countryCode` became optional for the status `200`
  - the response property `related/chart/countryName` became optional for the status `200`
  - the response property `related/chart/frequency` became optional for the status `200`
  - the response property `related/chart/maxResultsCount` became optional for the status `200`
  - the response property `related/chart/metric` became optional for the status `200`
  - the response property `related/chart/name` became optional for the status `200`
  - the response property `related/chart/platform` became optional for the status `200`
  - the response property `related/chart/slug` became optional for the status `200`
  - the response property `related/chart/type` became optional for the status `200`
  - the response property `related/chart/webUrl` became optional for the status `200`
  - api operation id `get_charts_song_ranking_2.14` removed and replaced with ``
  - the `code` response's property default value `0` was removed for the status `200`
  - the `creditName` response's property default value `` was removed for the status `200`
  - the `description` response's property default value `No metric available` was removed for the status `200`
  - the `imageUrl` response's property default value `` was removed for the status `200`
  - the `items` response's property default value `` was removed for the status `200`
  - the `key` response's property default value `` was removed for the status `200`
  - the `message` response's property default value `` was removed for the status `200`
  - the `name` response's property default value `` was removed for the status `200`
  - the `total` response's property default value `0` was removed for the status `200`
  - the `type` response's property default value `none` was removed for the status `200`
  - the `uuid` response's property default value `` was removed for the status `200`
- **2026-11-10** `001f23a14a51`: 3 breaking, 39 info
  - the response property `items/items/entryDate` became nullable for the status `200`
  - the response property `items/items/metric` became nullable for the status `200`
  - the response property `related/date` became nullable for the status `200`
  - api operation id `get_charts_song_ranking_2.14` was added
  - the response property `errors` became required for the status `200`
  - the response property `items/items/entryState` became required for the status `200`
  - the response property `items/items/oldPosition` became required for the status `200`
  - the response property `items/items/position` became required for the status `200`
  - the response property `items/items/positionEvolution` became required for the status `200`
  - the response property `items/items/rankDate` became required for the status `200`
  - the response property `items/items/song` became required for the status `200`
  - the response property `items/items/timeOnChart` became required for the status `200`
  - the response property `items/items/timeOnChartUnit` became required for the status `200`
  - the response property `page` became required for the status `200`
  - the response property `page/limit` became required for the status `200`
  - the response property `page/next` became required for the status `200`
  - the response property `page/offset` became required for the status `200`
  - the response property `page/previous` became required for the status `200`
  - the response property `related` became required for the status `200`
  - the response property `related/chart` became required for the status `200`
  - the response property `related/chart/cityName` became required for the status `200`
  - the response property `related/chart/countryCode` became required for the status `200`
  - the response property `related/chart/countryName` became required for the status `200`
  - the response property `related/chart/frequency` became required for the status `200`
  - the response property `related/chart/maxResultsCount` became required for the status `200`
  - the response property `related/chart/metric` became required for the status `200`
  - the response property `related/chart/name` became required for the status `200`
  - the response property `related/chart/platform` became required for the status `200`
  - the response property `related/chart/slug` became required for the status `200`
  - the response property `related/chart/type` became required for the status `200`
  - the response property `related/chart/webUrl` became required for the status `200`
  - the `code` response's property default value `0` was added for the status `200`
  - the `creditName` response's property default value `` was added for the status `200`
  - the `description` response's property default value `No metric available` was added for the status `200`
  - the `imageUrl` response's property default value `` was added for the status `200`
  - the `items` response's property default value `` was added for the status `200`
  - the `key` response's property default value `` was added for the status `200`
  - the `message` response's property default value `` was added for the status `200`
  - the `name` response's property default value `` was added for the status `200`
  - the `total` response's property default value `0` was added for the status `200`
  - …2 more

---

[Operation](https://skmtc.dev/soundcharts/apis/soundcharts-api/docs/api/v2.14/chart/song/:slug/ranking/:datetime/get.md) - [API](https://skmtc.dev/soundcharts/apis/soundcharts-api.md) - [Page](https://skmtc.dev/soundcharts/apis/soundcharts-api/changes/api/v2.14/chart/song/:slug/ranking/:datetime/get)
