Get Chats

Retrieve chat rooms (conversations) for a specific account. Provide an account_id to scope the results, and optionally filter by an artist_account_id. The endpoint returns metadata about each room, including the topic, associated artist, and last updated timestamp.

GET /api/chats

cURL

cURL

curl --request GET \
  --url https://recoup-api.vercel.app/api/chats \
  --header 'x-api-key: <api-key>'

200

{
  "status": "success",
  "chats": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "topic": "<string>",
      "updated_at": "2023-11-07T05:31:56Z",
      "artist_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ]
}

Authorizations

x-api-key · string · header · required

Your Recoup API key. Learn more.

Query Parameters

account_id · string<uuid> · required

UUID of the account whose chats to retrieve

artist_account_id · string<uuid>

Optional. Filter chats to only include those for the specified artist.

Response

200

application/json

Chats retrieved successfully

status · enum<string> · required

Status of the request

Available options: success

chats · object[] · required

Array of chat room objects

Show child attributes