CallRail API v1 Documentation
Getting started with the CallRail API is simple. With this guide, you can make your first API request in a matter of minutes.
Obtaining your API Key
- From your CallRail dashboard, in the top right corner select ‘My Account’ -> ‘Account’.
- From the ‘Account’ sub-menu, select ‘API Access’.
- Click the button on the top right that says ‘Add API Key’.
- Your API Key will now appear in the table.
The CallRail API authenticates via the HTTP Authorization header. Your request must include a header in the format:
Authorization: Token token="YOUR_API_KEY"
The CallRail API is JSON formatted. When submitting JSON data in the request body via
PUT requests you must include a Content-Type header specifying the format.
Your API key can be used for up to 1,000 requests per day. If you expect that your application will require more requests, please contact our support team.
Making an API Request with cURL
To make an API request from the command line via cURL, run this command:
curl -H "Authorization: Token token=YOUR_API_KEY" \ https://api.callrail.com/v1/companies.json
Making an API Request with Postman
These parameters are available for all methods which can return more than one object.
page: The page number of the current request. The first page is 1 (as opposed to 0).
per_page: The total number of objects to return in one request. The default value is 100 and the maximum value is 250.
General Response Fields
These items are returned from all methods which can return more than one object.
page: The page number of the current request.
per_page: The total number of objects to return in one request.
total_entries: The total number of objects that fit your query parameters.
total_pages: The total number of pages that fit your query parameters.
CallRail API Objects
- API v1 - Companies
- API v1 - Users
- API v1 - Sources
- API v1 - Source Trackers
- API v1 - Session Trackers
- API v1 - Call and SMS Alerts
- API v1 - Calls
- API v1 - Tags
- API v1 - Integrations