---
title: "Resolves soundcloud.com and on.soundcloud.com URLs to Resource URLs to use with the API."
method: GET
path: "/resolve"
tags: ["miscellaneous"]
---

# Resolves soundcloud.com and on.soundcloud.com URLs to Resource URLs to use with the API.

`GET /resolve`

## Request

- Base URL: `https://api.soundcloud.com`
- URL: `https://api.soundcloud.com/resolve`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://secure.soundcloud.com/authorize`
    - Client credentials
    - Token URL: `https://secure.soundcloud.com/oauth/token`
- TypeScript: <https://skmtc.dev/soundcloud/apis/soundcloud-public-api-specification/docs/resolve/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `url` string, required

## Other responses

- `302`: Found
- `404`: Not Found

## Changes

- **2026-07-17** `ab7b2ffc0193`: 1 breaking, 1 info
  - the `errors/items/` response's property type changed from `string` to `object` for status `404`
  - added the optional property `errors/items/error_message` to the response with the `404` status

[Operation history](https://skmtc.dev/soundcloud/apis/soundcloud-public-api-specification/changes/resolve/get.md)

---

[API](https://skmtc.dev/soundcloud/apis/soundcloud-public-api-specification.md) - [All operations](https://skmtc.dev/soundcloud/apis/soundcloud-public-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/soundcloud/apis/soundcloud-public-api-specification/revisions/0d057017b405?raw)