---
title: "retrieve recent calls for an account"
method: GET
path: "/ServiceProviders/{ServiceProviderSid}/RecentCalls"
tags: ["Recent Calls"]
---

# retrieve recent calls for an account

`GET /ServiceProviders/{ServiceProviderSid}/RecentCalls`

<Error>This endpoint is only availble with an Admin or Service Provider API key</Error>

## Response `200`

retrieve recent call records for a specified account

- object
  - `total` integer — total number of records in that database that match the filter criteria
  - `batch` integer — total number of records returned in this page set
  - `page` integer — page number that was requested, and is being returned
  - `data` object[]
    - `service_provider_sid` string, uuid
    - `account_sid` string, uuid, required
    - `call_sid` string, uuid, required
    - `from` string, required
    - `to` string, required
    - `answered` boolean, required
    - `sip_call_id` string
    - `sip_status` integer, required
    - `duration` integer, required
    - `attempted_at` integer, required
    - `answered_at` integer
    - `terminated_at` integer, required
    - `termination_reason` string
    - `host` string
    - `remote_host` string
    - `direction` 'inbound' | 'outbound', required
    - `trunk` string

## Other responses

- `404` — account not found

---

[API](https://skmtc.net/jambonz/apis/jambonz-api.md) · [All operations](https://skmtc.net/jambonz/apis/jambonz-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jambonz/jambonz-api/revisions/56f317145d23/schema)