---
title: "Get Playlist Last Updated Time"
method: GET
path: "/api/playlist/{platform}/{id}/updated"
tags: ["Playlist"]
---

# Get Playlist Last Updated Time

`GET /api/playlist/{platform}/{id}/updated`

## Request

- Base URL: `https://api.chartmetric.com`
- URL: `https://api.chartmetric.com/api/playlist/{platform}/{id}/updated`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/docs/api/playlist/:platform/:id/updated/get.ts> (a function with typed inputs; its response is checked against the schema)

Return the last time the playlist itself was observed updated by Chartmetric, and the most recent track add/removal events. For Spotify, also includes `tracks_last_updated` from the ClickHouse cache.

## Path parameters

- `platform` 'spotify' | 'itunes' | 'applemusic' | 'deezer' | 'amazon' | 'youtube' | 'boomplay' | 'soundcloud', required: Streaming platform. One of `spotify`, `itunes`/`applemusic`, `deezer`, `amazon`, `youtube`, `boomplay`, `soundcloud`.
- `id` union, required: Chartmetric playlist ID. Numeric for `spotify`/`itunes`/`applemusic`/`boomplay`; numeric string (bigInt) for `deezer`; string for `amazon`/`youtube`.
  - integer
  - string
  - string

## Query parameters

- `storefront` string: ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').

## Response `200`

Success

- object
  - `obj` object, nullable
    - `sys_last_updated` string, date-time, nullable: Date when Chartmetric last refreshed the playlist and its stats.
    - `playlist_last_updated` string, date-time, nullable: Date when a track was last added to or removed from the playlist.
    - `last_added` string, date-time, nullable: Date when a track was last added to the playlist.
    - `last_removed` string, date-time, nullable: Date when a track was last removed from the playlist.
    - `tracks_last_updated` string, date-time, nullable: Date the ClickHouse tracks cache was last refreshed for the playlist (Spotify only).

---

[API](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api.md) - [All operations](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/revisions/94dac96833a3?raw)