List Smartlinks

List Smartlinks. Use it to create and maintain release landing pages, DSP destinations, analytics visibility, and personal or organization smartlink preferences. It returns public references and organization-visible fields only, so clients can safely use returned values in follow-up API calls.

Authorization

BearerAuth

AuthorizationBearer <token>

In: header

Query Parameters

search?string

Search term for matching visible records.

page?integer

Page number to return.

size?integer

Number of records per page.

sort?string

Sort direction for creation date.

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/smartlinks?search=midnight&page=1&size=20&sort=desc"

{  "success": true,  "data": [    {      "smartlink_id": "1fdf8564-81f7-4607-9c8b-154b62db8d5f",      "release": {        "release_id": "b7a15d95-58f6-4f67-b5d1-89f4f5bfb4d8",        "title": "Midnight Atlas",        "status": "draft"      },      "slug": "nova-vale-midnight-atlas",      "title": "Midnight Atlas",      "status": "published",      "public_url": "https://links.northstar-distribution.co.uk/nova-vale-midnight-atlas",      "destinations": [        {          "platform": "spotify",          "url": "https://open.spotify.com/album/4Gj9kL2mN8rT6bY1xQvP3z",          "enabled": true        },        {          "platform": "apple_music",          "url": "https://music.apple.com/gb/album/midnight-atlas/1784529016",          "enabled": true        }      ],      "clicks": 1840,      "conversion_rate": 0.18,      "updated_at": "2026-07-04T10:15:00+00:00"    }  ],  "meta": {    "current_page": 1,    "last_page": 1,    "per_page": 20,    "total": 1,    "from": 1,    "to": 1  }}

Authorization

Query Parameters

Response Body

200application/json

401application/json

403application/json

422application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`