Endpoints

List the latest calls

List the 50 latest phone calls in the caller's org, newest first, each with id, direction, outcome, number, Prospect name, time, duration, source and operator name. Optional search on phone, Prospect name or team member name; test-lab calls are left out. Open one with phone.get_voice_call. Requires `phone:call`.

GET /v1/phone/list_calls

Parameters

Name	In	Required	Type	Description
`search`	query	No	`string`	Text to find in the phone number, the Prospect name or the team member name; 100 characters.

Request examples

Set MYREMOTELY_BASE_URL to the environment you intend to call.

curl --fail-with-body \
  --header "x-api-key: $MYREMOTELY_API_KEY" \
  "$MYREMOTELY_BASE_URL/v1/phone/list_calls"

const baseUrl = process.env.MYREMOTELY_BASE_URL
const apiKey = process.env.MYREMOTELY_API_KEY

if (!baseUrl || !apiKey) throw new Error('API base URL and key are required')

const response = await fetch(`${baseUrl}/v1/phone/list_calls`, {
  method: 'GET',
  headers: { 'x-api-key': apiKey },
})

if (!response.ok) throw new Error(`Request failed: ${response.status}`)
const data = await response.json()

Responses

200 Success

application/json

Field	Type	Required	Description
`calls`	`array`	Yes	—

{
  "calls": [
    {
      "id": "string",
      "direction": "string",
      "outcome": "string",
      "phoneNumber": "string",
      "displayName": "string",
      "occurredAt": "string",
      "durationSeconds": "string",
      "leadId": "string",
      "contactId": "string",
      "source": "string",
      "operatorName": "string",
      "recording": "string",
      "transcript": "string"
    }
  ]
}

400 The list limit is outside the supported range or is not an integer.

application/problem+json

Field	Type	Required	Description
`type`	`string`	Yes	A stable documentation URI for this problem.
`title`	`string`	Yes	A short problem title.
`detail`	`string`	Yes	A safe explanation of this occurrence.
`code`	`string`	Yes	A stable machine-readable problem code.
`requestId`	`string`	Yes	The request ID to include when contacting MyRemotely support.
`status`	`number`	Yes	The HTTP status code.

{
  "type": "https://app.myremotely.ai/en/docs/errors#invalid-request",
  "title": "Invalid request",
  "status": 400,
  "detail": "The limit must be an integer from 1 to 100.",
  "code": "invalid_request",
  "requestId": "request_demo_01"
}

401 The API key is missing, invalid, expired, or revoked.

application/problem+json

Field	Type	Required	Description
`type`	`string`	Yes	A stable documentation URI for this problem.
`title`	`string`	Yes	A short problem title.
`detail`	`string`	Yes	A safe explanation of this occurrence.
`code`	`string`	Yes	A stable machine-readable problem code.
`requestId`	`string`	Yes	The request ID to include when contacting MyRemotely support.
`status`	`number`	Yes	The HTTP status code.

{
  "type": "https://app.myremotely.ai/en/docs/errors#invalid-api-key",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Provide a valid API key.",
  "code": "invalid_api_key",
  "requestId": "request_demo_01"
}

403 The API key does not have the `phone:call` scope.

application/problem+json

Field	Type	Required	Description
`type`	`string`	Yes	A stable documentation URI for this problem.
`title`	`string`	Yes	A short problem title.
`detail`	`string`	Yes	A safe explanation of this occurrence.
`code`	`string`	Yes	A stable machine-readable problem code.
`requestId`	`string`	Yes	The request ID to include when contacting MyRemotely support.
`status`	`number`	Yes	The HTTP status code.

{
  "type": "https://app.myremotely.ai/en/docs/errors#missing-scope",
  "title": "Forbidden",
  "status": 403,
  "detail": "The phone:call scope is required.",
  "code": "missing_scope",
  "requestId": "request_demo_01"
}

429 The API key request budget is exhausted.

application/problem+json

Field	Type	Required	Description
`type`	`string`	Yes	A stable documentation URI for this problem.
`title`	`string`	Yes	A short problem title.
`detail`	`string`	Yes	A safe explanation of this occurrence.
`code`	`string`	Yes	A stable machine-readable problem code.
`requestId`	`string`	Yes	The request ID to include when contacting MyRemotely support.
`status`	`number`	Yes	The HTTP status code.

{
  "type": "https://app.myremotely.ai/en/docs/errors#rate-limited",
  "title": "Too many requests",
  "status": 429,
  "detail": "Try the request again later.",
  "code": "rate_limited",
  "requestId": "request_demo_01"
}

500 MyRemotely could not complete the request.

application/problem+json

Field	Type	Required	Description
`type`	`string`	Yes	A stable documentation URI for this problem.
`title`	`string`	Yes	A short problem title.
`detail`	`string`	Yes	A safe explanation of this occurrence.
`code`	`string`	Yes	A stable machine-readable problem code.
`requestId`	`string`	Yes	The request ID to include when contacting MyRemotely support.
`status`	`number`	Yes	The HTTP status code.

{
  "type": "https://app.myremotely.ai/en/docs/errors#internal-error",
  "title": "Internal error",
  "status": 500,
  "detail": "The request could not be completed.",
  "code": "internal_error",
  "requestId": "request_demo_01"
}

Last updated Oct 3, 2026

List the latest calls

Parameters

Request examples

Responses

200 Success

400 The list limit is outside the supported range or is not an integer.

401 The API key is missing, invalid, expired, or revoked.

403 The API key does not have the phone:call scope.

429 The API key request budget is exhausted.

500 MyRemotely could not complete the request.

403 The API key does not have the `phone:call` scope.