{
    "item": [
        {
            "name": "authentication",
            "description": "Exchange your partner credentials for a session token. Tokens live 8 hours; send them raw in the `Authorization` header (no `Bearer ` prefix). Re-authenticate automatically whenever you receive a `401`.",
            "item": [
                {
                    "id": "fa192cbe-bb70-4344-9c93-aa8ee31bfde1",
                    "name": "Create a session token",
                    "request": {
                        "name": "Create a session token",
                        "description": {
                            "content": "Exchanges your `client_id` + `client_signature` for an 8-hour JWT session token.\n\nDuring normal service the token is at `session.token.token` (note the nesting — this differs from `/partners/session/with-user`, where `session.token` is the string itself). Send it raw in the `Authorization` header on all other endpoints.\n\n**During standby mode the shape differs**: the endpoint returns a short-lived (~15 min) token *without verifying credentials*, and `session.token` is the JWT **string directly** (no inner object). Handle both: `typeof session.token === 'string' ? session.token : session.token.token`. Standby-minted tokens stop working (401) as soon as normal service resumes.",
                            "type": "text/plain"
                        },
                        "url": {
                            "path": [
                                "partners",
                                "session"
                            ],
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "query": [],
                            "variable": []
                        },
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "method": "POST",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n  \"client_id\": \"a1b2c3d4e5\",\n  \"client_signature\": \"f6e5d4c3b2a1098765432109876543210fedcba9\"\n}",
                            "options": {
                                "raw": {
                                    "headerFamily": "json",
                                    "language": "json"
                                }
                            }
                        },
                        "auth": {
                            "type": "noauth"
                        }
                    },
                    "response": [
                        {
                            "id": "f57206a8-dd0c-479b-aea9-558d7e6f3217",
                            "name": "Session created. `session.token` is an object during normal service and a plain JWT string during standby mode (see examples).",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "session"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    }
                                ],
                                "method": "POST",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n  \"client_id\": \"a1b2c3d4e5\",\n  \"client_signature\": \"f6e5d4c3b2a1098765432109876543210fedcba9\"\n}",
                                    "options": {
                                        "raw": {
                                            "headerFamily": "json",
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                },
                                {
                                    "disabled": false,
                                    "description": {
                                        "content": "",
                                        "type": "text/plain"
                                    },
                                    "key": "x-fitradio-served-by",
                                    "value": ""
                                }
                            ],
                            "body": "{\n  \"session\": {\n    \"token\": {\n      \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjaWQiOiJhMWIyYzNkNGU1IiwidWlkIjoxMjUwOTQ3NiwiaWF0IjoxNzU0MzgwODAwLCJleHAiOjE3NTQ0MDk2MDB9.signature\",\n      \"error\": null\n    }\n  }\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "ab7d76d1-2aef-4f7c-91bb-9ae652b22c91",
                            "name": "Credentials invalid.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "session"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    }
                                ],
                                "method": "POST",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n  \"client_id\": \"a1b2c3d4e5\",\n  \"client_signature\": \"f6e5d4c3b2a1098765432109876543210fedcba9\"\n}",
                                    "options": {
                                        "raw": {
                                            "headerFamily": "json",
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"credentials invalid\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "d3ad31a5-5594-4987-9d08-9630cd305ba3",
                            "name": "`client_id` or `client_signature` missing from the request body.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "session"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    }
                                ],
                                "method": "POST",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n  \"client_id\": \"a1b2c3d4e5\",\n  \"client_signature\": \"f6e5d4c3b2a1098765432109876543210fedcba9\"\n}",
                                    "options": {
                                        "raw": {
                                            "headerFamily": "json",
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"please provide user information to create session: email, salt\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "6f845881-c936-4d13-ba32-83e0d4316608",
                            "name": "Internal error. Retry with backoff; contact FitRadio if it persists.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "session"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    }
                                ],
                                "method": "POST",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n  \"client_id\": \"a1b2c3d4e5\",\n  \"client_signature\": \"f6e5d4c3b2a1098765432109876543210fedcba9\"\n}",
                                    "options": {
                                        "raw": {
                                            "headerFamily": "json",
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Internal Server Error",
                            "code": 500,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"internal service error\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        }
                    ],
                    "event": [],
                    "protocolProfileBehavior": {
                        "disableBodyPruning": true
                    }
                },
                {
                    "id": "55192b51-306c-4554-8207-87d3b5dc399e",
                    "name": "Create a session token bound to a partner account",
                    "request": {
                        "name": "Create a session token bound to a partner account",
                        "description": {
                            "content": "Like `POST /partners/session`, but additionally requires the partner account `email` registered with FitRadio and binds the token to that partner identity. Use this variant if your agreement uses the restricted catalog (`GET /partners/catalog/restricted`) — the restricted endpoint filters by the partner identity carried in this token.\n\n**Note the response shape difference:** here `session.token` is the JWT string directly, while `/partners/session` nests it one level deeper (`session.token.token`).",
                            "type": "text/plain"
                        },
                        "url": {
                            "path": [
                                "partners",
                                "session",
                                "with-user"
                            ],
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "query": [],
                            "variable": []
                        },
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "method": "POST",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n  \"client_id\": \"a1b2c3d4e5\",\n  \"client_signature\": \"f6e5d4c3b2a1098765432109876543210fedcba9\",\n  \"email\": \"integration@yourcompany.com\"\n}",
                            "options": {
                                "raw": {
                                    "headerFamily": "json",
                                    "language": "json"
                                }
                            }
                        },
                        "auth": {
                            "type": "noauth"
                        }
                    },
                    "response": [
                        {
                            "id": "48e25716-96d2-4b16-870e-5873b2c58db6",
                            "name": "Session created.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "session",
                                        "with-user"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    }
                                ],
                                "method": "POST",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n  \"client_id\": \"a1b2c3d4e5\",\n  \"client_signature\": \"f6e5d4c3b2a1098765432109876543210fedcba9\",\n  \"email\": \"integration@yourcompany.com\"\n}",
                                    "options": {
                                        "raw": {
                                            "headerFamily": "json",
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                },
                                {
                                    "disabled": false,
                                    "description": {
                                        "content": "",
                                        "type": "text/plain"
                                    },
                                    "key": "x-fitradio-served-by",
                                    "value": ""
                                }
                            ],
                            "body": "{\n  \"session\": {\n    \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjaWQiOiJhMWIyYzNkNGU1IiwidWlkIjo0MiwiaWF0IjoxNzU0MzgwODAwLCJleHAiOjE3NTQ0MDk2MDB9.signature\"\n  }\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "80305f18-52dc-45c4-94f5-3361f727cd63",
                            "name": "Credentials invalid, partner not found for the given email, or session creation failed.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "session",
                                        "with-user"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    }
                                ],
                                "method": "POST",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n  \"client_id\": \"a1b2c3d4e5\",\n  \"client_signature\": \"f6e5d4c3b2a1098765432109876543210fedcba9\",\n  \"email\": \"integration@yourcompany.com\"\n}",
                                    "options": {
                                        "raw": {
                                            "headerFamily": "json",
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"credentials invalid\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "3b8e80f4-890d-4780-8930-fbdfbd068b25",
                            "name": "`client_id` or `client_signature` missing from the request body.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "session",
                                        "with-user"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    }
                                ],
                                "method": "POST",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n  \"client_id\": \"a1b2c3d4e5\",\n  \"client_signature\": \"f6e5d4c3b2a1098765432109876543210fedcba9\",\n  \"email\": \"integration@yourcompany.com\"\n}",
                                    "options": {
                                        "raw": {
                                            "headerFamily": "json",
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"please provide user information to create session: email, client_id, client_signature\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "73e582c3-6825-4513-be3c-7c6de9004f16",
                            "name": "Internal error. Retry with backoff; contact FitRadio if it persists.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "session",
                                        "with-user"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    }
                                ],
                                "method": "POST",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n  \"client_id\": \"a1b2c3d4e5\",\n  \"client_signature\": \"f6e5d4c3b2a1098765432109876543210fedcba9\",\n  \"email\": \"integration@yourcompany.com\"\n}",
                                    "options": {
                                        "raw": {
                                            "headerFamily": "json",
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Internal Server Error",
                            "code": 500,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"internal service error\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        }
                    ],
                    "event": [],
                    "protocolProfileBehavior": {
                        "disableBodyPruning": true
                    }
                }
            ]
        },
        {
            "name": "catalog",
            "description": "The entry point for content discovery: the pages (music rows) of the partner catalog. Use `/partners/catalog/restricted` if your partner agreement scopes you to a subset of the catalog.",
            "item": [
                {
                    "id": "1cede131-4717-4ef0-a6c6-effd4f6030b6",
                    "name": "List catalog pages",
                    "request": {
                        "name": "List catalog pages",
                        "description": {
                            "content": "Returns the pages (music rows) of the partner catalog — the top level of the content hierarchy. Use each entry's `page_id` with `GET /partners/page/{page_id}`.",
                            "type": "text/plain"
                        },
                        "url": {
                            "path": [
                                "partners",
                                "catalog"
                            ],
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "query": [],
                            "variable": []
                        },
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "method": "GET",
                        "body": {},
                        "auth": null
                    },
                    "response": [
                        {
                            "id": "01c841fc-24fe-45cb-94b2-8567548d5497",
                            "name": "Catalog pages.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "catalog"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "OK",
                            "code": 200,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                },
                                {
                                    "disabled": false,
                                    "description": {
                                        "content": "",
                                        "type": "text/plain"
                                    },
                                    "key": "x-fitradio-served-by",
                                    "value": ""
                                }
                            ],
                            "body": "{\n  \"catalogs\": [\n    {\n      \"page_id\": 71,\n      \"title\": \"Featured\",\n      \"type\": \"genre\",\n      \"ranking\": 1,\n      \"list_count\": 12\n    },\n    {\n      \"page_id\": 46,\n      \"title\": \"SWEATBASE\",\n      \"type\": \"genre\",\n      \"ranking\": 2,\n      \"list_count\": 8\n    }\n  ]\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "a59acfc9-4292-4835-b6a8-b5077699b2db",
                            "name": "No catalog available.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "catalog"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"no catalogs available\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "3f9e46b8-7a38-4b36-9faa-86e5ab61b8f2",
                            "name": "Session token missing, malformed, expired, or minted during standby. The body is plain text, not JSON. Create a new session via `POST /partners/session` and retry.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "catalog"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "text/plain"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "text/plain"
                                }
                            ],
                            "body": "Unauthorized",
                            "cookie": [],
                            "_postman_previewlanguage": "text"
                        },
                        {
                            "id": "f893803a-baf4-4bb3-a56d-ad6afcac484f",
                            "name": "Internal error. Retry with backoff; contact FitRadio if it persists.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "catalog"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Internal Server Error",
                            "code": 500,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"internal service error\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "4e1311dc-0232-4773-93ed-55dc7dd58dac",
                            "name": "The standby failover failed to serve the request. Retry with backoff.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "catalog"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"standby upstream error\"\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        }
                    ],
                    "event": [],
                    "protocolProfileBehavior": {
                        "disableBodyPruning": true
                    }
                },
                {
                    "id": "d20ed96b-1bfb-4239-88d4-c30ce1be3c14",
                    "name": "List catalog pages allowed for your partner account",
                    "request": {
                        "name": "List catalog pages allowed for your partner account",
                        "description": {
                            "content": "Same shape as `GET /partners/catalog`, additionally filtered by the content restrictions configured for your partner account.\n\nThe partner identity is read from the session token, so call this with a token from `POST /partners/session/with-user`. With a plain `/partners/session` token (no partner identity), the response falls back to the unrestricted country catalog.",
                            "type": "text/plain"
                        },
                        "url": {
                            "path": [
                                "partners",
                                "catalog",
                                "restricted"
                            ],
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "query": [],
                            "variable": []
                        },
                        "header": [
                            {
                                "disabled": false,
                                "description": {
                                    "content": "ISO 3166-1 alpha-2 country. On production Cloudflare sets it automatically from the caller's IP; server-to-server integrations may send it explicitly. Read only by this endpoint (the partner-restriction lookup is per country); values that are not exactly two letters are ignored.",
                                    "type": "text/plain"
                                },
                                "key": "CF-IPCountry",
                                "value": "US"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "method": "GET",
                        "body": {},
                        "auth": null
                    },
                    "response": [
                        {
                            "id": "b1a912af-3c14-4e68-a368-3c68b05c8b2c",
                            "name": "Catalog pages allowed for this partner.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "catalog",
                                        "restricted"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "disabled": false,
                                        "description": {
                                            "content": "ISO 3166-1 alpha-2 country. On production Cloudflare sets it automatically from the caller's IP; server-to-server integrations may send it explicitly. Read only by this endpoint (the partner-restriction lookup is per country); values that are not exactly two letters are ignored.",
                                            "type": "text/plain"
                                        },
                                        "key": "CF-IPCountry",
                                        "value": "US"
                                    },
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "OK",
                            "code": 200,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                },
                                {
                                    "disabled": false,
                                    "description": {
                                        "content": "",
                                        "type": "text/plain"
                                    },
                                    "key": "x-fitradio-served-by",
                                    "value": ""
                                }
                            ],
                            "body": "{\n  \"catalogs\": [\n    {\n      \"page_id\": 46,\n      \"title\": \"SWEATBASE\",\n      \"type\": \"genre\",\n      \"ranking\": 1,\n      \"list_count\": 8\n    }\n  ]\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "86dccf01-b653-464f-88d6-4e92726a248b",
                            "name": "No catalog available for this partner.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "catalog",
                                        "restricted"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "disabled": false,
                                        "description": {
                                            "content": "ISO 3166-1 alpha-2 country. On production Cloudflare sets it automatically from the caller's IP; server-to-server integrations may send it explicitly. Read only by this endpoint (the partner-restriction lookup is per country); values that are not exactly two letters are ignored.",
                                            "type": "text/plain"
                                        },
                                        "key": "CF-IPCountry",
                                        "value": "US"
                                    },
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"no catalogs available for this partner\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "41fd0d8a-4f0b-460e-bc99-f6bf8be70821",
                            "name": "Session token missing, malformed, expired, or minted during standby. The body is plain text, not JSON. Create a new session via `POST /partners/session` and retry.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "catalog",
                                        "restricted"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "disabled": false,
                                        "description": {
                                            "content": "ISO 3166-1 alpha-2 country. On production Cloudflare sets it automatically from the caller's IP; server-to-server integrations may send it explicitly. Read only by this endpoint (the partner-restriction lookup is per country); values that are not exactly two letters are ignored.",
                                            "type": "text/plain"
                                        },
                                        "key": "CF-IPCountry",
                                        "value": "US"
                                    },
                                    {
                                        "key": "Accept",
                                        "value": "text/plain"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "text/plain"
                                }
                            ],
                            "body": "Unauthorized",
                            "cookie": [],
                            "_postman_previewlanguage": "text"
                        },
                        {
                            "id": "a6b96f7b-be73-4057-b12b-d739eb695863",
                            "name": "Internal error. Retry with backoff; contact FitRadio if it persists.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "catalog",
                                        "restricted"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "disabled": false,
                                        "description": {
                                            "content": "ISO 3166-1 alpha-2 country. On production Cloudflare sets it automatically from the caller's IP; server-to-server integrations may send it explicitly. Read only by this endpoint (the partner-restriction lookup is per country); values that are not exactly two letters are ignored.",
                                            "type": "text/plain"
                                        },
                                        "key": "CF-IPCountry",
                                        "value": "US"
                                    },
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Internal Server Error",
                            "code": 500,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"internal service error\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "e2e93efb-d2d4-4525-ad3b-adbf0151d4d5",
                            "name": "The standby failover failed to serve the request. Retry with backoff.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "catalog",
                                        "restricted"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "disabled": false,
                                        "description": {
                                            "content": "ISO 3166-1 alpha-2 country. On production Cloudflare sets it automatically from the caller's IP; server-to-server integrations may send it explicitly. Read only by this endpoint (the partner-restriction lookup is per country); values that are not exactly two letters are ignored.",
                                            "type": "text/plain"
                                        },
                                        "key": "CF-IPCountry",
                                        "value": "US"
                                    },
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"standby upstream error\"\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        }
                    ],
                    "event": [],
                    "protocolProfileBehavior": {
                        "disableBodyPruning": true
                    }
                }
            ]
        },
        {
            "name": "page",
            "description": "A page (music row) groups related lists — e.g. a genre or featured collection. Returns the lists on the page.",
            "item": [
                {
                    "id": "fe224427-be96-4c20-b463-5eff991f9e7b",
                    "name": "Get the lists on a page",
                    "request": {
                        "name": "Get the lists on a page",
                        "description": {
                            "content": "Returns the lists on one catalog page. Use each list's `list_id` with `GET /partners/list/{list_id}`.",
                            "type": "text/plain"
                        },
                        "url": {
                            "path": [
                                "partners",
                                "page",
                                ":page_id"
                            ],
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "query": [],
                            "variable": [
                                {
                                    "type": "any",
                                    "value": "71",
                                    "key": "page_id",
                                    "disabled": false,
                                    "description": {
                                        "content": "(Required) Page id from `GET /partners/catalog` (`page_id`).",
                                        "type": "text/plain"
                                    }
                                }
                            ]
                        },
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "method": "GET",
                        "body": {},
                        "auth": null
                    },
                    "response": [
                        {
                            "id": "21a1ce87-57d5-4a72-a4f5-123052e116c9",
                            "name": "The page with its lists.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "page",
                                        ":page_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) Page id from `GET /partners/catalog` (`page_id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "71",
                                            "key": "page_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "OK",
                            "code": 200,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                },
                                {
                                    "disabled": false,
                                    "description": {
                                        "content": "",
                                        "type": "text/plain"
                                    },
                                    "key": "x-fitradio-served-by",
                                    "value": ""
                                }
                            ],
                            "body": "{\n  \"page\": {\n    \"id\": 71,\n    \"title\": \"Featured\",\n    \"lists\": [\n      {\n        \"list_id\": 529,\n        \"ranking\": 1,\n        \"title\": \"Straight Outta Hollywood\",\n        \"description\": \"Hip hop and Top 40 for lifting and HIIT workouts.\",\n        \"mix_count\": 14,\n        \"image\": {\n          \"thumbnail\": \"https://cdn.fitradio.com/resources/artwork/android_xxhdpi/0362102862_thumb.jpg\",\n          \"large\": \"https://cdn.fitradio.com/resources/artwork/0857061661_large.jpg\",\n          \"player\": \"https://cdn.fitradio.com/resources/artwork/1768199292_player.jpg\"\n        }\n      }\n    ]\n  }\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "7472e00e-b351-42ae-ab41-322b484f90c2",
                            "name": "Missing/unknown page id, or the page has no content.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "page",
                                        ":page_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) Page id from `GET /partners/catalog` (`page_id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "71",
                                            "key": "page_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"no results for given type\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "2c77256d-379f-42ff-b839-477943e014b5",
                            "name": "Session token missing, malformed, expired, or minted during standby. The body is plain text, not JSON. Create a new session via `POST /partners/session` and retry.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "page",
                                        ":page_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) Page id from `GET /partners/catalog` (`page_id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "71",
                                            "key": "page_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "text/plain"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "text/plain"
                                }
                            ],
                            "body": "Unauthorized",
                            "cookie": [],
                            "_postman_previewlanguage": "text"
                        },
                        {
                            "id": "9b19c278-f852-41e0-8d3e-3ed035ec186b",
                            "name": "Internal error. Retry with backoff; contact FitRadio if it persists.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "page",
                                        ":page_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) Page id from `GET /partners/catalog` (`page_id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "71",
                                            "key": "page_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Internal Server Error",
                            "code": 500,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"internal service error\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "35014288-a12a-46ce-a79e-75c403becab1",
                            "name": "The standby failover failed to serve the request. Retry with backoff.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "page",
                                        ":page_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) Page id from `GET /partners/catalog` (`page_id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "71",
                                            "key": "page_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"standby upstream error\"\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        }
                    ],
                    "event": [],
                    "protocolProfileBehavior": {
                        "disableBodyPruning": true
                    }
                }
            ]
        },
        {
            "name": "list",
            "description": "A list is an ordered collection of mixes (a station or curated genre list). Returns list metadata plus lightweight mix summaries.",
            "item": [
                {
                    "id": "fd08cae9-1b9f-4eb7-9c66-cda6529c55ba",
                    "name": "Get the mixes in a list",
                    "request": {
                        "name": "Get the mixes in a list",
                        "description": {
                            "content": "Returns one list's metadata plus lightweight summaries of its mixes. Use each mix's `id` with `GET /partners/mix/{mix_id}` to get playable URLs and the track listing.",
                            "type": "text/plain"
                        },
                        "url": {
                            "path": [
                                "partners",
                                "list",
                                ":list_id"
                            ],
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "query": [],
                            "variable": [
                                {
                                    "type": "any",
                                    "value": "529",
                                    "key": "list_id",
                                    "disabled": false,
                                    "description": {
                                        "content": "(Required) List id from `GET /partners/page/{page_id}` (`list_id`).",
                                        "type": "text/plain"
                                    }
                                }
                            ]
                        },
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "method": "GET",
                        "body": {},
                        "auth": null
                    },
                    "response": [
                        {
                            "id": "ff743e12-54bc-4865-a68f-0c25a00c2874",
                            "name": "The list with its mixes.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "list",
                                        ":list_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) List id from `GET /partners/page/{page_id}` (`list_id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "529",
                                            "key": "list_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "OK",
                            "code": 200,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                },
                                {
                                    "disabled": false,
                                    "description": {
                                        "content": "",
                                        "type": "text/plain"
                                    },
                                    "key": "x-fitradio-served-by",
                                    "value": ""
                                }
                            ],
                            "body": "{\n  \"list\": {\n    \"id\": 529,\n    \"ranking\": 1,\n    \"title\": \"Straight Outta Hollywood\",\n    \"description\": \"Hip hop and Top 40 for lifting and HIIT workouts.\",\n    \"image\": {\n      \"thumbnail\": \"https://cdn.fitradio.com/resources/artwork/android_xxhdpi/0362102862_thumb.jpg\",\n      \"large\": \"https://cdn.fitradio.com/resources/artwork/0857061661_large.jpg\",\n      \"player\": \"https://cdn.fitradio.com/resources/artwork/1768199292_player.jpg\"\n    },\n    \"mixes\": [\n      {\n        \"id\": 9252,\n        \"title\": \"Straight Outta Hollywood 3\",\n        \"description\": \"General lifting mix of hip hop, top 40, and EDM.\",\n        \"length\": \"00:56:13\",\n        \"explicit\": 0,\n        \"bpm\": 80,\n        \"max_bpm\": 150,\n        \"list_id\": 529\n      }\n    ]\n  }\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "773404b8-dec8-4de1-988b-75fe5c4c34d4",
                            "name": "Missing/unknown list id, or the list has no content.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "list",
                                        ":list_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) List id from `GET /partners/page/{page_id}` (`list_id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "529",
                                            "key": "list_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"no results for given type\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "c642699a-144b-41a3-ac69-c4d86fe1e25d",
                            "name": "Session token missing, malformed, expired, or minted during standby. The body is plain text, not JSON. Create a new session via `POST /partners/session` and retry.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "list",
                                        ":list_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) List id from `GET /partners/page/{page_id}` (`list_id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "529",
                                            "key": "list_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "text/plain"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "text/plain"
                                }
                            ],
                            "body": "Unauthorized",
                            "cookie": [],
                            "_postman_previewlanguage": "text"
                        },
                        {
                            "id": "c92c7c84-8209-4e36-acae-1b8fa85273f4",
                            "name": "Internal error. Retry with backoff; contact FitRadio if it persists.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "list",
                                        ":list_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) List id from `GET /partners/page/{page_id}` (`list_id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "529",
                                            "key": "list_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Internal Server Error",
                            "code": 500,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"internal service error\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "2657722d-b12c-448f-9f9d-0b0c0a1d7a09",
                            "name": "The standby failover failed to serve the request. Retry with backoff.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "list",
                                        ":list_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) List id from `GET /partners/page/{page_id}` (`list_id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "529",
                                            "key": "list_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"standby upstream error\"\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        }
                    ],
                    "event": [],
                    "protocolProfileBehavior": {
                        "disableBodyPruning": true
                    }
                }
            ]
        },
        {
            "name": "genres",
            "description": "Raw items of a single music row, with the full artwork set per item.",
            "item": [
                {
                    "id": "9e92c613-e813-4f19-9c68-9d1f568e9c7c",
                    "name": "Get the items of a music row with full artwork",
                    "request": {
                        "name": "Get the items of a music row with full artwork",
                        "description": {
                            "content": "Returns the raw items of a single music row with the complete artwork set per item (wide, spotlight, player, thumbnail, basic). Useful for building richer browse UIs than the catalog/page endpoints allow. Not country-filtered.",
                            "type": "text/plain"
                        },
                        "url": {
                            "path": [
                                "partners",
                                "genres",
                                ":music_row_id"
                            ],
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "query": [],
                            "variable": [
                                {
                                    "type": "any",
                                    "value": "46",
                                    "key": "music_row_id",
                                    "disabled": false,
                                    "description": {
                                        "content": "(Required) Music row id (same id space as catalog `page_id`).",
                                        "type": "text/plain"
                                    }
                                }
                            ]
                        },
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "method": "GET",
                        "body": {},
                        "auth": null
                    },
                    "response": [
                        {
                            "id": "919b2a09-2b02-46f6-bc91-4bdd1c71017f",
                            "name": "Items of the music row. `items` is `null` when the row exists but has no items.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "genres",
                                        ":music_row_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) Music row id (same id space as catalog `page_id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "46",
                                            "key": "music_row_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "OK",
                            "code": 200,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                },
                                {
                                    "disabled": false,
                                    "description": {
                                        "content": "",
                                        "type": "text/plain"
                                    },
                                    "key": "x-fitradio-served-by",
                                    "value": ""
                                }
                            ],
                            "body": "{\n  \"rows\": {\n    \"items\": [\n      {\n        \"id\": 529,\n        \"title\": \"Straight Outta Hollywood\",\n        \"description\": \"Hip hop and Top 40 for lifting and HIIT workouts.\",\n        \"bpm\": 80,\n        \"image\": \"https://cdn.fitradio.com/resources/artwork/0857061661_large.jpg\",\n        \"image_wide_url\": \"https://cdn.fitradio.com/resources/artwork/0857061661_wide.jpg\",\n        \"player_image\": \"https://cdn.fitradio.com/resources/artwork/1768199292_player.jpg\",\n        \"thumbnail\": \"https://cdn.fitradio.com/resources/artwork/0362102862_thumb.jpg\",\n        \"basic_image\": \"https://cdn.fitradio.com/resources/artwork/0857061661_basic.jpg\",\n        \"wide_image\": \"https://cdn.fitradio.com/resources/artwork/0857061661_wide.jpg\",\n        \"spotlight_image\": \"https://cdn.fitradio.com/resources/artwork/0857061661_spot.jpg\",\n        \"ordering\": 1\n      }\n    ]\n  }\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "654219ca-56c7-4608-875d-dc9dbf1b449c",
                            "name": "Music row id missing from the URL.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "genres",
                                        ":music_row_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) Music row id (same id space as catalog `page_id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "46",
                                            "key": "music_row_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"please provide a music row id as a URL parameter\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "4a095b42-84b4-400f-ac25-deafc8a3c8d2",
                            "name": "Session token missing, malformed, expired, or minted during standby. The body is plain text, not JSON. Create a new session via `POST /partners/session` and retry.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "genres",
                                        ":music_row_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) Music row id (same id space as catalog `page_id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "46",
                                            "key": "music_row_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "text/plain"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "text/plain"
                                }
                            ],
                            "body": "Unauthorized",
                            "cookie": [],
                            "_postman_previewlanguage": "text"
                        },
                        {
                            "id": "21f7f48f-be2a-48ca-9f45-d340d8e8d60b",
                            "name": "Internal error. Retry with backoff; contact FitRadio if it persists.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "genres",
                                        ":music_row_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) Music row id (same id space as catalog `page_id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "46",
                                            "key": "music_row_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Internal Server Error",
                            "code": 500,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"internal service error\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "59965b9e-b0d0-4041-b4f6-fc4b87e74370",
                            "name": "The standby failover failed to serve the request. Retry with backoff.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "genres",
                                        ":music_row_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) Music row id (same id space as catalog `page_id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "46",
                                            "key": "music_row_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"standby upstream error\"\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        }
                    ],
                    "event": [],
                    "protocolProfileBehavior": {
                        "disableBodyPruning": true
                    }
                }
            ]
        },
        {
            "name": "mix",
            "description": "A mix is a continuous DJ mix. The detail endpoint returns everything needed for playback and compliance: HLS stream URLs (iOS/Android renditions), MP3 URL, artwork, DJ info, and the full track listing with ISRCs.",
            "item": [
                {
                    "id": "cb77694c-dd82-4d66-b467-ced3999e6e77",
                    "name": "Get a mix with playback URLs and track listing",
                    "request": {
                        "name": "Get a mix with playback URLs and track listing",
                        "description": {
                            "content": "Returns everything needed to play one mix and stay license-compliant:\n\n* `android_hls_url` / `ios_hls_url` — ready-to-play HLS manifests per platform. `hls_url` mirrors the Android rendition for backwards compatibility.\n* `url` — the raw MP3.\n* `tracks` — the full track listing with each track's `isrc` and start `time`, which you need for royalty reporting.\n\nThis endpoint is **not** geo-gated.\n\nDuring standby mode, all three HLS fields may point at the same rendition and some metadata may be degraded (equal `min_bpm`/`max_bpm`, empty `description`).",
                            "type": "text/plain"
                        },
                        "url": {
                            "path": [
                                "partners",
                                "mix",
                                ":mix_id"
                            ],
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "query": [],
                            "variable": [
                                {
                                    "type": "any",
                                    "value": "9252",
                                    "key": "mix_id",
                                    "disabled": false,
                                    "description": {
                                        "content": "(Required) Mix id from `GET /partners/list/{list_id}` (`mixes[].id`).",
                                        "type": "text/plain"
                                    }
                                }
                            ]
                        },
                        "header": [
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "method": "GET",
                        "body": {},
                        "auth": null
                    },
                    "response": [
                        {
                            "id": "812b56ef-21e2-4514-8c4d-1b76a5047e43",
                            "name": "The mix.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "mix",
                                        ":mix_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) Mix id from `GET /partners/list/{list_id}` (`mixes[].id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "9252",
                                            "key": "mix_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "OK",
                            "code": 200,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                },
                                {
                                    "disabled": false,
                                    "description": {
                                        "content": "",
                                        "type": "text/plain"
                                    },
                                    "key": "x-fitradio-served-by",
                                    "value": ""
                                }
                            ],
                            "body": "{\n  \"mix\": {\n    \"id\": 9252,\n    \"title\": \"Straight Outta Hollywood 3\",\n    \"description\": \"General lifting mix of hip hop, top 40, and EDM.\",\n    \"length\": \"00:56:13\",\n    \"min_bpm\": 80,\n    \"max_bpm\": 150,\n    \"explicit\": false,\n    \"url\": \"https://cdn.fitradio.com/resources/mixes/1703282564_straight_outta_hollywood_3.mp3\",\n    \"android_hls_url\": \"https://cdn.fitradio.com/hls_android/mix_9252_android.m3u8\",\n    \"ios_hls_url\": \"https://cdn.fitradio.com/hls_ios/9252/mix_9252.m3u8\",\n    \"hls_url\": \"https://cdn.fitradio.com/hls_android/mix_9252_android.m3u8\",\n    \"image_large\": \"https://cdn.fitradio.com/resources/artwork/0857061661_art.jpg\",\n    \"image_thumbnail\": \"https://cdn.fitradio.com/resources/artwork/ios_retina/0857061661_art.jpg\",\n    \"dj\": {\n      \"name\": \"Breis Gordan\",\n      \"image_large\": \"https://cdn.fitradio.com/resources/artwork/1768199292_dj.jpg\",\n      \"image_thumbnail\": \"https://cdn.fitradio.com/resources/artwork/ios_retina/1768199292_dj.jpg\"\n    },\n    \"tracks\": [\n      {\n        \"id\": 704991,\n        \"time\": \"00:00:00\",\n        \"isrc\": \"USUM71703861\",\n        \"artist\": \"Example Artist\",\n        \"title\": \"Example Track\"\n      },\n      {\n        \"id\": 704992,\n        \"time\": \"00:03:33\",\n        \"isrc\": \"GBUM71603392\",\n        \"artist\": \"Another Artist\",\n        \"title\": \"Another Track\"\n      }\n    ],\n    \"genres\": [\n      {\n        \"id\": 2,\n        \"title\": \"Hip Hop\",\n        \"description\": \"Hip hop and rap workout mixes.\"\n      }\n    ],\n    \"tags\": [\n      \"lifting\",\n      \"crossfit\"\n    ]\n  }\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "7bc42058-b0be-4a4d-9bcc-381c47e8eab0",
                            "name": "Mix id missing from the URL.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "mix",
                                        ":mix_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) Mix id from `GET /partners/list/{list_id}` (`mixes[].id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "9252",
                                            "key": "mix_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"Please provide a mix ID as a URL parameter\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "88c3676e-26a9-42d8-a5e8-65e7aa2e54fb",
                            "name": "Session token missing, malformed, expired, or minted during standby. The body is plain text, not JSON. Create a new session via `POST /partners/session` and retry.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "mix",
                                        ":mix_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) Mix id from `GET /partners/list/{list_id}` (`mixes[].id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "9252",
                                            "key": "mix_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "text/plain"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "text/plain"
                                }
                            ],
                            "body": "Unauthorized",
                            "cookie": [],
                            "_postman_previewlanguage": "text"
                        },
                        {
                            "id": "099492d5-ee7e-4fc3-82bc-c163228af54e",
                            "name": "No mix with this id.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "mix",
                                        ":mix_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) Mix id from `GET /partners/list/{list_id}` (`mixes[].id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "9252",
                                            "key": "mix_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Not Found",
                            "code": 404,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"Mix not found\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "1650d0ac-c2c5-4b6e-a928-f997fbce57d9",
                            "name": "Internal error. Retry with backoff; contact FitRadio if it persists.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "mix",
                                        ":mix_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) Mix id from `GET /partners/list/{list_id}` (`mixes[].id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "9252",
                                            "key": "mix_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Internal Server Error",
                            "code": 500,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"internal service error\",\n  \"mix\": null\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "14b7e97b-b1dc-49ae-a0cf-cc6254065eac",
                            "name": "The standby failover failed to serve the request. Retry with backoff.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "mix",
                                        ":mix_id"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": [
                                        {
                                            "disabled": false,
                                            "description": {
                                                "content": "(Required) Mix id from `GET /partners/list/{list_id}` (`mixes[].id`).",
                                                "type": "text/plain"
                                            },
                                            "type": "any",
                                            "value": "9252",
                                            "key": "mix_id"
                                        }
                                    ]
                                },
                                "header": [
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "GET",
                                "body": {}
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"standby upstream error\"\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        }
                    ],
                    "event": [],
                    "protocolProfileBehavior": {
                        "disableBodyPruning": true
                    }
                }
            ]
        },
        {
            "name": "royalty",
            "description": "Report every track play. Required for licensing compliance — integrations are not approved for launch until reporting is verified end-to-end by FitRadio. Read the *Data types and formats* section above before implementing.",
            "item": [
                {
                    "id": "9838a194-9e3c-4d90-b701-a717d37cdb2a",
                    "name": "Report a track play",
                    "request": {
                        "name": "Report a track play",
                        "description": {
                            "content": "Report every track play — one call per track, sent when the track finishes (or playback stops). Required for licensing compliance.\n\n**Read the *Data types and formats* section first.** The most common integration mistakes, all of which corrupt reporting silently or fail the request:\n\n* `playedat` sent in seconds instead of **milliseconds**\n* numeric fields serialized with a trailing `.0`\n* `playlength`, `userid`, or `isrc` omitted\n\n`isrc` should be echoed from the mix's track listing; if omitted, FitRadio falls back to looking it up from `trackid`, but sending it explicitly is strongly preferred. Send your real per-request values — do not hardcode example payloads from this page.",
                            "type": "text/plain"
                        },
                        "url": {
                            "path": [
                                "partners",
                                "royalty-tracking"
                            ],
                            "host": [
                                "{{baseUrl}}"
                            ],
                            "query": [],
                            "variable": []
                        },
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json"
                            }
                        ],
                        "method": "POST",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n  \"trackid\": 704991,\n  \"playedat\": 1754380800000,\n  \"playlength\": 213,\n  \"sourcestream\": \"mix\",\n  \"sourcedetail\": \"9252\",\n  \"os\": \"web\",\n  \"device\": \"chrome\",\n  \"country\": \"US\",\n  \"vendor\": 12,\n  \"userid\": 42,\n  \"uuid\": \"3f6a1c2e-8f4b-4b7e-9d2a-5c8e1f0a9b3d\",\n  \"isrc\": \"USUM71703861\",\n  \"endreason\": 1,\n  \"cachedplay\": false,\n  \"jumpforward\": false\n}",
                            "options": {
                                "raw": {
                                    "headerFamily": "json",
                                    "language": "json"
                                }
                            }
                        },
                        "auth": null
                    },
                    "response": [
                        {
                            "id": "70e37f0a-8241-45f7-8ae8-cd1dff05be95",
                            "name": "Play accepted.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "royalty-tracking"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "POST",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n  \"trackid\": 704991,\n  \"playedat\": 1754380800000,\n  \"playlength\": 213,\n  \"sourcestream\": \"mix\",\n  \"sourcedetail\": \"9252\",\n  \"os\": \"web\",\n  \"device\": \"chrome\",\n  \"country\": \"US\",\n  \"vendor\": 12,\n  \"userid\": 42,\n  \"uuid\": \"3f6a1c2e-8f4b-4b7e-9d2a-5c8e1f0a9b3d\",\n  \"isrc\": \"USUM71703861\",\n  \"endreason\": 1,\n  \"cachedplay\": false,\n  \"jumpforward\": false\n}",
                                    "options": {
                                        "raw": {
                                            "headerFamily": "json",
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                },
                                {
                                    "disabled": false,
                                    "description": {
                                        "content": "",
                                        "type": "text/plain"
                                    },
                                    "key": "x-fitradio-served-by",
                                    "value": ""
                                }
                            ],
                            "body": "{\n  \"error\": false,\n  \"message\": \"success\"\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "59d9d105-b840-473a-8550-213e2ee6af0f",
                            "name": "One or more required fields are missing or invalid. `message` lists the offending fields.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "royalty-tracking"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "POST",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n  \"trackid\": 704991,\n  \"playedat\": 1754380800000,\n  \"playlength\": 213,\n  \"sourcestream\": \"mix\",\n  \"sourcedetail\": \"9252\",\n  \"os\": \"web\",\n  \"device\": \"chrome\",\n  \"country\": \"US\",\n  \"vendor\": 12,\n  \"userid\": 42,\n  \"uuid\": \"3f6a1c2e-8f4b-4b7e-9d2a-5c8e1f0a9b3d\",\n  \"isrc\": \"USUM71703861\",\n  \"endreason\": 1,\n  \"cachedplay\": false,\n  \"jumpforward\": false\n}",
                                    "options": {
                                        "raw": {
                                            "headerFamily": "json",
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"message\": \"include the required fields: playedat,country\"\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "611895e2-7a97-4ace-968d-3f10f047ab70",
                            "name": "Session token missing, malformed, expired, or minted during standby. The body is plain text, not JSON. Create a new session via `POST /partners/session` and retry.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "royalty-tracking"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Accept",
                                        "value": "text/plain"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "POST",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n  \"trackid\": 704991,\n  \"playedat\": 1754380800000,\n  \"playlength\": 213,\n  \"sourcestream\": \"mix\",\n  \"sourcedetail\": \"9252\",\n  \"os\": \"web\",\n  \"device\": \"chrome\",\n  \"country\": \"US\",\n  \"vendor\": 12,\n  \"userid\": 42,\n  \"uuid\": \"3f6a1c2e-8f4b-4b7e-9d2a-5c8e1f0a9b3d\",\n  \"isrc\": \"USUM71703861\",\n  \"endreason\": 1,\n  \"cachedplay\": false,\n  \"jumpforward\": false\n}",
                                    "options": {
                                        "raw": {
                                            "headerFamily": "json",
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Unauthorized",
                            "code": 401,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "text/plain"
                                }
                            ],
                            "body": "Unauthorized",
                            "cookie": [],
                            "_postman_previewlanguage": "text"
                        },
                        {
                            "id": "61d632b6-e547-4b99-a97a-9be637b57aa0",
                            "name": "Internal error. Queue the report and retry with backoff.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "royalty-tracking"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "POST",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n  \"trackid\": 704991,\n  \"playedat\": 1754380800000,\n  \"playlength\": 213,\n  \"sourcestream\": \"mix\",\n  \"sourcedetail\": \"9252\",\n  \"os\": \"web\",\n  \"device\": \"chrome\",\n  \"country\": \"US\",\n  \"vendor\": 12,\n  \"userid\": 42,\n  \"uuid\": \"3f6a1c2e-8f4b-4b7e-9d2a-5c8e1f0a9b3d\",\n  \"isrc\": \"USUM71703861\",\n  \"endreason\": 1,\n  \"cachedplay\": false,\n  \"jumpforward\": false\n}",
                                    "options": {
                                        "raw": {
                                            "headerFamily": "json",
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Internal Server Error",
                            "code": 500,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"message\": \"internal service error\"\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        },
                        {
                            "id": "c0e90097-6467-41f1-bf8b-65184c405237",
                            "name": "The standby failover failed to serve the request. Retry with backoff.",
                            "originalRequest": {
                                "url": {
                                    "path": [
                                        "partners",
                                        "royalty-tracking"
                                    ],
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "query": [],
                                    "variable": []
                                },
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    },
                                    {
                                        "key": "Accept",
                                        "value": "application/json"
                                    },
                                    {
                                        "description": {
                                            "content": "Added as a part of security scheme: apikey",
                                            "type": "text/plain"
                                        },
                                        "key": "Authorization",
                                        "value": "<API Key>"
                                    }
                                ],
                                "method": "POST",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n  \"trackid\": 704991,\n  \"playedat\": 1754380800000,\n  \"playlength\": 213,\n  \"sourcestream\": \"mix\",\n  \"sourcedetail\": \"9252\",\n  \"os\": \"web\",\n  \"device\": \"chrome\",\n  \"country\": \"US\",\n  \"vendor\": 12,\n  \"userid\": 42,\n  \"uuid\": \"3f6a1c2e-8f4b-4b7e-9d2a-5c8e1f0a9b3d\",\n  \"isrc\": \"USUM71703861\",\n  \"endreason\": 1,\n  \"cachedplay\": false,\n  \"jumpforward\": false\n}",
                                    "options": {
                                        "raw": {
                                            "headerFamily": "json",
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Service Unavailable",
                            "code": 503,
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"error\": true,\n  \"reason\": \"standby upstream error\"\n}",
                            "cookie": [],
                            "_postman_previewlanguage": "json"
                        }
                    ],
                    "event": [],
                    "protocolProfileBehavior": {
                        "disableBodyPruning": true
                    }
                }
            ]
        }
    ],
    "auth": {
        "type": "apikey",
        "apikey": [
            {
                "type": "any",
                "value": "Authorization",
                "key": "key"
            },
            {
                "type": "any",
                "value": "{{apiKey}}",
                "key": "value"
            },
            {
                "type": "any",
                "value": "header",
                "key": "in"
            }
        ]
    },
    "event": [],
    "variable": [
        {
            "key": "baseUrl",
            "value": "https://p.stg.env.fitradio.com"
        }
    ],
    "info": {
        "_postman_id": "6e0f4ba5-a0e6-48c3-abc0-99d40708bebf",
        "name": "FitRadio Partner API",
        "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
        "description": {
            "content": "# Overview\n\nThe FitRadio Partner API gives approved partners access to FitRadio's licensed workout-music catalog. The content model is a simple hierarchy:\n\n**Catalog → Page → List → Mix**\n\n1. `GET /partners/catalog` returns the *pages* (music rows) of the partner catalog.\n2. `GET /partners/page/{page_id}` returns the *lists* on one page.\n3. `GET /partners/list/{list_id}` returns the *mixes* in one list.\n4. `GET /partners/mix/{mix_id}` returns one mix with its playable HLS/MP3 URLs, artwork, DJ, and full track listing.\n5. `POST /partners/royalty-tracking` reports every track play back to FitRadio — required for licensing compliance.\n\n# Base URL\n\nAll endpoints are served from `https://p.stg.env.fitradio.com`.\n\n# Authentication\n\nAll endpoints except the two `POST /partners/session*` endpoints require a session token.\n\n1. FitRadio issues you a `client_id` and `client_signature` out of band.\n2. Call `POST /partners/session` with them. The response contains a JWT session token.\n3. Send that token on every subsequent request in the `Authorization` header.\n\n**Important — send the raw token.** The `Authorization` header value must be the JWT *by itself*, with **no `Bearer ` prefix** and no other decoration:\n\n```\nAuthorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjaWQiOi...\n```\n\nA value of `Bearer eyJ...` is rejected with `401`.\n\nThere is **no** `X-Client-Id` header anywhere in this API. Older documentation that mentioned one was wrong — the session token is the only credential sent on API calls.\n\nTokens expire **8 hours** after issue. Any `401` response means your token is missing, malformed, expired, or was minted during standby mode (see below) — create a new session and retry. Build automatic re-authentication on `401` into your client.\n\n# Quickstart\n\n```bash\n# 1. Create a session\ncurl -s -X POST https://p.stg.env.fitradio.com/partners/session \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"client_id\": \"YOUR_CLIENT_ID\", \"client_signature\": \"YOUR_CLIENT_SIGNATURE\"}'\n# → {\"session\":{\"token\":{\"token\":\"eyJhbGciOi...\",\"error\":null}}}\n\nTOKEN='eyJhbGciOi...'   # the inner session.token.token value, used raw\n\n# 2. Discover content\ncurl -s https://p.stg.env.fitradio.com/partners/catalog        -H \"Authorization: $TOKEN\"\ncurl -s https://p.stg.env.fitradio.com/partners/page/71        -H \"Authorization: $TOKEN\"\ncurl -s https://p.stg.env.fitradio.com/partners/list/529       -H \"Authorization: $TOKEN\"\ncurl -s https://p.stg.env.fitradio.com/partners/mix/9252       -H \"Authorization: $TOKEN\"\n\n# 3. Report a play (required for every track you play)\ncurl -s -X POST https://p.stg.env.fitradio.com/partners/royalty-tracking \\\n  -H \"Authorization: $TOKEN\" -H 'Content-Type: application/json' \\\n  -d '{\n    \"trackid\": 704991,\n    \"playedat\": 1754380800000,\n    \"playlength\": 213,\n    \"sourcestream\": \"mix\",\n    \"sourcedetail\": \"9252\",\n    \"os\": \"web\",\n    \"device\": \"chrome\",\n    \"country\": \"US\",\n    \"vendor\": 12,\n    \"userid\": 42,\n    \"isrc\": \"USUM71703861\",\n    \"endreason\": 1\n  }'\n```\n\n# Data types and formats\n\nThese rules exist because getting them wrong silently corrupts royalty reporting. Please read them carefully.\n\n| Rule | Detail |\n|---|---|\n| **IDs are JSON integers** | Send `\"trackid\": 704991` — never `704991.0`, never `\"704991\"`. Serializers that add a trailing `.0` (e.g. Python floats, spreadsheet exports) break processing. |\n| **`playedat` is epoch milliseconds** | A 13-digit Unix timestamp, e.g. `1754380800000`. Sending *seconds* (10 digits) is not rejected but corrupts play-time reporting — always milliseconds. |\n| **`playlength` is seconds** | Integer number of seconds the track actually played, e.g. `213`. |\n| **Mix/track durations are strings** | `length` and `time` fields are `HH:MM:SS` strings, e.g. `\"00:56:13\"`. |\n| **ISRC** | Every track in `GET /partners/mix/{mix_id}` includes its `isrc` (International Standard Recording Code). Echo the value back in royalty reports **exactly as received** — do not reformat, trim, or reconstruct it. |\n| **Country codes** | ISO 3166-1 alpha-2, uppercase, e.g. `US`, `GB`, `DE`. |\n\n# Country\n\nCatalog, page, list and mix responses are **not** filtered by country: every partner sees the same catalog. The `country` field of a royalty report is **required** and must be the listener's country (ISO 3166-1 alpha-2); a report without it is rejected with `400`. It is never inferred from the request's IP or headers.\n\nRequesting a page or list id that has no content returns `400` with `reason: \"no results for given type\"`.\n\n# Standby mode\n\nWhen FitRadio's primary database is unavailable, the API automatically fails over to a read-only standby service so playback keeps working. What changes for you:\n\n* Responses include the header `x-fitradio-served-by: standby` (or `live-bypass`). Absence of the header means normal live service.\n* `POST /partners/session` succeeds **without verifying credentials** and returns a short-lived token (~15 minutes) — and the response shape flattens: `session.token` is the JWT **string** directly instead of the live `{token, error}` object. Extract with `typeof session.token === 'string' ? session.token : session.token.token`.\n* Standby-minted tokens are **rejected with `401` the moment normal service resumes.** This is the main reason your client must re-authenticate automatically on any `401`.\n* Some catalog metadata is served from cache and may be degraded (e.g. a mix's `min_bpm`/`max_bpm` may be equal, `description` may be empty).\n* `POST /partners/royalty-tracking` accepts and acknowledges reports; queue and re-send your reports after standby ends if you require delivery guarantees.\n\n# Errors\n\nTwo error envelopes are in use:\n\n* Most endpoints: `{ \"error\": true, \"reason\": \"<human-readable message>\", \"mix\": null }` (the legacy `mix` field is always `null` and can be ignored).\n* `POST /partners/royalty-tracking`: `{ \"error\": true, \"message\": \"<human-readable message>\" }`.\n* `401` responses from the authentication layer have a plain-text body (`Unauthorized`), not JSON.\n\n| Status | Meaning |\n|---|---|\n| `400` | Missing/invalid parameter, or no content for the given id |\n| `401` | Missing, malformed, expired, or standby-minted token; invalid session credentials |\n| `404` | Mix not found |\n| `500` | Internal error — retry with backoff, then contact FitRadio |\n| `503` | Standby failover error — retry with backoff |\n\n# Downloads\n\n* [Raw OpenAPI spec](./openapi.json)\n* [Postman collection](./fitradio-partner-api.postman_collection.json)\n\n\nContact Support:\n Name: FitRadio Partner Support",
            "type": "text/plain"
        }
    }
}