Developer API
Call history API: GET /api/v1/calls
Pull your recent calls into your own system: what each field means, how to fetch only new calls, and how to match calls to your contacts.
Which plans include it
Included on Plus and above. On Free Trial, Entry you can add it on its own at £2.50 a month from Features & add-ons.
What it means
A list of the calls on your account, newest first, the same calls you see in Call Records in the dashboard.
What it does
- Address: GET https://www.siluxcall.co.uk/api/v1/calls with your key.
- limit: how many calls (1 to 200, default 50).
- since: only calls that started at or after this time, for example 2026-11-04T09:00:00Z.
- before: only calls that started before this time (use it to page back through older calls).
Every part of the page
- id
- Our id for the call.
- direction
- "inbound" or "outbound".
- from / to
- The calling and called numbers.
- status
- How it ended, for example "answered", "no answer", "busy" or "failed".
- durationSeconds
- Length of the call in seconds.
- startedAt / answeredAt / endedAt
- Times in UTC (ISO 8601). answeredAt is empty for unanswered calls.
- recordingId
- If the call was recorded, the id to download it with the recordings API; otherwise empty.
How to use it
Fetch only new calls every few minutes
- Remember the startedAt of the newest call you have saved.
- Ask https://www.siluxcall.co.uk/api/v1/calls?since=<that time>&limit=200.
- Save any call whose id you have not seen before.
- Repeat every 5 to 15 minutes. That uses far fewer than the 10,000 requests a day a key allows.
Page back through older calls
- Ask for ?limit=200.
- Take the startedAt of the oldest call in the reply and ask again with ?before=<that time>&limit=200.
- Stop when the reply is empty.
Match calls to your contacts
- For an inbound call, look up "from" in your contacts; for an outbound call, look up "to".
- Compare the last 10 digits, so 01632960123 and +441632960123 match.
Examples
One call in the reply
{"id":"…","direction":"outbound","from":"441632960000","to":"01632960123","status":"answered","durationSeconds":203,"startedAt":"2026-11-04T10:39:57.000Z","answeredAt":"2026-11-04T10:40:05.000Z","endedAt":"2026-11-04T10:43:28.000Z","recordingId":null}
Recommended settings
- ★Use a webhook (Settings → Webhooks) when you need calls the moment they start or end, and this API to fill gaps or for reports.
- ★Store times in UTC and convert to UK time only when you display them.
Abbreviations on this page
- API key
- A secret password that lets one piece of software use another. Treat it like a password.
- Example: Treat an API key like a password: anyone with it can use your account's API.
- Webhook
- An automatic message our system sends to a web address you choose whenever something happens, such as a call ending. Used to connect other software.
- Example: When a call ends, a webhook sends its details to your own system automatically.
Questions
Does the API show call costs?+
No. Your bill and minutes are on the Billing and Minutes pages in the dashboard.
How far back can I go?+
As far back as your Call Records page in the dashboard; use "before" to page back.
Which plans include the API?+
It is part of the package on Plus, Growth, Pro and Enterprise at no extra cost. On Entry, add API access for £2.50 a month from Features & add-ons. The Free Trial does not include it. There is no per-call API fee.