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

# retrieve recent calls for an account

`GET /Accounts/{AccountSid}/RecentCalls`

## Path parameters

- `AccountSid` string, uuid, required

## Query parameters

- `page` integer, required — page number of data to retrieve
- `count` integer, required — number of rows to retrieve in each page set
- `days` integer — number of days back to retrieve,
- `start` string, date-time — start date to retrieve
- `end` string, date-time — end date to retrieve
- `answered` 'true' | 'false' — retrieve only answered calls
- `direction` 'inbound' | 'outbound'
- `filter` string

## 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[]
    - `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)