Learn how to obtain an API key, access endpoints, and construct a call.
Keys
Using the API requires a key for authentication. Each key is linked with one API user; access to the data will be linked to the same access level of the API user role.
- To obtain or create new keys navigate to Top Menu >> Setup >> API and add an API User.
- Note: A key is like a combined username + password to your RPM subscription. Keep it secure.
API Access URL And Endpoints
All the API calls are done through one web service, available at the following URL:
RPM Telco:
https://secure.rpmtelco.com/rpm/api2.svc/<api-endpoint>
API Usage Limit
As of RPM 33.1, the RPM API has no usage limits. Instead, subscribers choose a monthly usage plan. Exceeding it will not limit usage but overage fees will apply. More information here: RPM API Access and Usage.
How to Construct a Request to Our API
All the requests to the API are done using JSON formatting and the HTTP POST method is required.
Every request sent to the API requires the call parameters to be provided in JSON format. Regardless of what endpoint you are trying to request, you need to provide the API key in the HTTP request header in the following way:
Any request with a missing API Key will respond with an error:
Invalid keys produce errors too:
Example Request:
Response