Skip to main content
GET
/
api
/
artist
/
segments
cURL
curl --request GET \
  --url https://recoup-api.vercel.app/api/artist/segments \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "segments": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "artist_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "segment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "updated_at": "2023-11-07T05:31:56Z",
      "segment_name": "<string>",
      "artist_name": "<string>"
    }
  ],
  "pagination": {
    "total_count": 123,
    "page": 123,
    "limit": 123,
    "total_pages": 123
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
artist_account_id
string<uuid>
required

The unique identifier of the artist account to fetch segments for

​
page
integer
default:1

The page number to retrieve (default: 1)

​
limit
integer
default:20

The number of records per page (default: 20, max: 100)

Required range: x <= 100

Response

Segments retrieved successfully

​
status
enum<string>
required

Status of the request

Available options:
success
​
segments
object[]
required

List of segment objects associated with the artist

​
pagination
object
required

Pagination metadata for the response