PROs API Documentation

Performing rights organizations (PROs) are a fixed, shared list. Composers and publishers refer to one by its id, which is the PRO’s society code, and searches can filter on a composer’s PRO with the pro_id field.

Endpoints

GET /api/v1/pros

Retrieve every PRO. The whole list fits on one page.

Query Parameters

Name	Type	Description
q	string	List only the PROs with this in their abbreviation or their country, whatever its case
per_page	integer	Records per page, up to 200. The list comes whole unless this is given.
page	integer	Page number, with `per_page`

Response

{
    "pagination": {
        "total_entries": 190,
        "per_page": 999,
        "current_page": 1,
        "total_pages": 1
    },
    "pros": [
        {
            "id": 0,
            "abbreviation": "DP",
            "country_name": null,
            "url": "https://app.spondulix.ai/api/v1/pros/0"
        },
        {
            "id": 1,
            "abbreviation": "ACUM",
            "country_name": "Israel",
            "url": "https://app.spondulix.ai/api/v1/pros/1"
        },
        etc.
    ]
}

Response Fields

Field	Type	Description
pagination	object	Contains pagination information (PROs are always on a single page)
pros	array	List of PRO objects
id	integer	Society code for the PRO
abbreviation	string	Abbreviation of the PRO’s name
country_name	string	Name of the country the PRO is located in
url	string	URL of the PRO

HTTP Response Codes

Code	Description
`200 OK`	Successful request

GET /api/v1/pros/{id}

Retrieve a PRO.

Path Parameters

Name	Type	Description	Required
id	integer	Society code of the PRO	Yes

Response

{
    "id": 21,
    "abbreviation": "BMI",
    "country_name": "United States of America (the)",
    "url": "https://app.spondulix.ai/api/v1/pros/21"
}

HTTP Response Codes

Code	Description
`200 OK`	Successful request
`404 Not Found`	Unknown PRO ID