GET /releases

GET /releases

Headers

  • Range string

    Limiting and Pagination

  • Range-Unit string

    Limiting and Pagination

    Default value is items.

  • Prefer string

    Preference

    Value is count=none.

Query parameters

  • catalog_number string
  • created string
  • genre string
  • id string
  • is_compilation string
  • label string
  • release_date string
  • subgenre string
  • release_title string
  • upc_code string
  • updated string
  • release_version string
  • contracts string
  • media_assets string
  • language string
  • tracks string
  • slug string
  • cover_artwork string
  • description string
  • bandcamp string
  • vinyl string
  • org_id string
  • label_id string
  • genre_id string
  • subgenre_id string
  • select string

    Filtering Columns

  • order string

    Ordering

  • offset string

    Limiting and Pagination

  • limit string

    Limiting and Pagination

Responses

  • 200

    OK

    Hide response attributes Show response attributes object
    • catalog_number string(text)

      Default value is empty.

    • created string(timestamp with time zone) Required

      Default value is now().

    • genre string(text)

      Default value is empty.

    • id string(uuid) Required

      Note: This is a Primary Key.

      Default value is extensions.uuid_generate_v4().

    • is_compilation boolean(boolean)

      Default value is false.

    • label string(text)

      Default value is empty.

    • release_date string(date)
    • subgenre string(text)

      Default value is empty.

    • release_title string(text)

      Default value is empty.

    • upc_code string(text)

      Default value is empty.

    • updated string(timestamp with time zone) Required

      Default value is now().

    • release_version string(text)

      Default value is empty.

    • contracts
    • media_assets
    • language string(text)

      Default value is empty.

    • tracks
    • slug string(text)

      Default value is empty.

    • cover_artwork
    • description string(text)

      Default value is empty.

    • bandcamp string(text)

      Default value is empty.

    • vinyl string(text)

      Default value is empty.

    • org_id string(text)

      Default value is empty.

    • label_id string(uuid)

      Note: This is a Foreign Key to labels.id.

    • genre_id string(uuid)

      Note: This is a Foreign Key to genres.id.

    • subgenre_id string(uuid)

      Note: This is a Foreign Key to subgenres.id.

  • 206

    Partial Content

GET /releases
curl \
 --request GET 'https://api.audiokit.ai:443/releases' \
 --header "Range: string" \
 --header "Range-Unit: items" \
 --header "Prefer: count=none"
Response examples (200)
[
  {
    "catalog_number": "",
    "created": "now()",
    "genre": "",
    "id": "extensions.uuid_generate_v4()",
    "is_compilation": false,
    "label": "",
    "release_date": "2025-05-04",
    "subgenre": "",
    "release_title": "",
    "upc_code": "",
    "updated": "now()",
    "release_version": "",
    "language": "",
    "slug": "",
    "description": "",
    "bandcamp": "",
    "vinyl": "",
    "org_id": "",
    "label_id": "string",
    "genre_id": "string",
    "subgenre_id": "string"
  }
]