Skip to main content
GET
/
api
/
v1
/
info
/
provider-roles
cURL
curl --request GET \
  --url https://sdp.suki.ai/api/v1/info/provider-roles \
  --header 'sdp_suki_token: <sdp_suki_token>' \
  --header 'sdp_provider_id: <sdp_provider_id>'
{
  "provider_roles": [
    {
      "code": "ATTENDING"
    }
  ]
}
Use this endpoint to get the list of supported roles.

​
Code examples

import requests

url = "https://sdp.suki-stage.com/api/v1/info/provider-roles"
headers = {
    "sdp_suki_token": "<sdp_suki_token>",
    "sdp_provider_id": "<sdp_provider_id>"
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    provider_roles_data = response.json()
    print("Supported Provider Roles:")
    for provider_role in provider_roles_data.get("provider_roles", []):
        print(f"  {provider_role.get('code')}")
else:
    print(f"Failed to get provider roles: {response.status_code}")
    print(response.json())

Headers

​
sdp_suki_token
string
required

sdp_suki_token

​
sdp_provider_id
string

Unique identifier for the provider. Optional for standard partners. Required for Single Auth Token authentication, where multiple providers share the same partner_token.

Example:

"provider-123"

Response

Success Response

Response body for the /info/provider-roles endpoint

​
provider_roles
object[]

List of supported provider roles

Last modified on June 12, 2026