---
title: "Find calls"
method: GET
path: "/calls"
tags: ["Calls"]
---

# Find calls

`GET /calls`

Find calls by query parameters.

## Query parameters

- `from` string, phonenumber
- `to` string, phonenumber
- `trunkId` string
- `createTime` string
- `callResult` 'COMPLETED' | 'NO_ANSWER' | 'CANCEL' | 'BUSY' | 'FAILED' — The result of the call.
- `direction` 'INBOUND' | 'OUTBOUND' — Filter results based on the call direction.
- `page` string
- `size` integer

## Response `200`

Call result response

- object
  - `calls` Call[] — The list of calls that matches the query parameters.
    - `callId` string, ULID — The unique identifier of the call.
    - `to` string — For `INBOUND` calls, this is the Sinch number the phone dialed. For `OUTBOUND` calls, this is the phone number you want to make a call to. Formatted according e164 format.
    - `from` string, phoneNumber — For `INBOUND` calls, this is the number of the person calling. When making an outbound call set this to the your Sinch number you want to show up as Caller Id. The call's origination, formatted according to the call's `callType`. For calls in the telephone network, this is a phone number in [E.164](https://community.sinch.com/t5/Glossary/E-164/ta-p/7537) format, including the leading `+`.
    - `direction` 'INBOUND' | 'OUTBOUND' — Describes whether the call was `INBOUND` *to* your Sinch number or was `OUTBOUND` and made *from* your Sinch number.
    - `answerTime` string, date-time — Time when call was answered
    - `endTime` string, date-time — The time the call ended
    - `durationSeconds` integer — The duration of the call in seconds. For inbound calls, this is the time from when the call started until the call ended. For outbound calls, this is the time from when the call was answered until the call ended.
    - `callResult` 'COMPLETED' | 'NO_ANSWER' | 'CANCEL' | 'BUSY' | 'FAILED' — The result of the call.
    - `pricePerMinute` Money
      - `currencyCode` string — The 3-letter currency code defined in ISO 4217.
      - `amount` string — The amount with 4 decimals and decimal delimiter `.`.
    - `billingDurationSeconds` integer — The duration of the call adjusted with the billing period.
    - `price` Money
      - `currencyCode` string — The 3-letter currency code defined in ISO 4217.
      - `amount` string — The amount with 4 decimals and decimal delimiter `.`.
    - `createTime` string, date-time — The time the call was created.
    - `projectId` string — The ID of the project that the call belongs to.
    - `trunkId` string — The ID of the trunk that the call was made through.
    - `pcapId` string — The ID of the PCAP that can be retrieved. PCAPs are only stored for 10 days.
  - `totalItems` integer — Total size of the result.
  - `pageNumber` string — The token to be used for listing the next page
  - `size` integer — The number of items per page. default is 1000

---

[API](https://skmtc.net/sinch/apis/elastic-sip-trunk-api.md) · [All operations](https://skmtc.net/sinch/apis/elastic-sip-trunk-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinch/elastic-sip-trunk-api/revisions/c04c2c708bf9/schema)