Fetch multiple call resources

GET

texml

Accounts

{account_sid}

Calls

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const response = await client.texml.accounts.calls.retrieveCalls('account_sid');

console.log(response.calls);

import os
from telnyx import Telnyx

client = Telnyx(
    api_key=os.environ.get("TELNYX_API_KEY"),  # This is the default and can be omitted
)
response = client.texml.accounts.calls.retrieve_calls(
    account_sid="account_sid",
)
print(response.calls)

package main

import (
	"context"
	"fmt"

	"github.com/team-telnyx/telnyx-go"
	"github.com/team-telnyx/telnyx-go/option"
)

func main() {
	client := telnyx.NewClient(
		option.WithAPIKey("My API Key"),
	)
	response, err := client.Texml.Accounts.Calls.GetCalls(
		context.TODO(),
		"account_sid",
		telnyx.TexmlAccountCallGetCallsParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", response.Calls)
}

package com.telnyx.sdk.example;

import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.texml.accounts.calls.CallRetrieveCallsParams;
import com.telnyx.sdk.models.texml.accounts.calls.CallRetrieveCallsResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        TelnyxClient client = TelnyxOkHttpClient.fromEnv();

        CallRetrieveCallsResponse response = client.texml().accounts().calls().retrieveCalls("account_sid");
    }
}

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Telnyx\Client;
use Telnyx\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');

try {
  $response = $client->texml->accounts->calls->retrieveCalls(
    'account_sid',
    endTime: 'EndTime',
    endTimeGt: 'EndTime_gt',
    endTimeLt: 'EndTime_lt',
    from: 'From',
    page: 0,
    pageSize: 0,
    pageToken: 'PageToken',
    startTime: 'StartTime',
    startTimeGt: 'StartTime_gt',
    startTimeLt: 'StartTime_lt',
    status: 'canceled',
    to: 'To',
  );

  var_dump($response);
} catch (APIException $e) {
  echo $e->getMessage();
}

{
  "calls": [],
  "end": 0,
  "first_page_uri": "/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls.json?Page=0&PageSize=1",
  "next_page_uri": "/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls.json?Page=1&PageSize=1&PageToken=MTY4AjgyNDkwNzIxMQ",
  "page": 0,
  "page_size": 1,
  "start": 0,
  "uri": "/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls.json?Page=0&PageSize=1"
}

{
  "errors": [
    {
      "detail": "Resource not found"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

account_sid

string

required

The UUID of the Telnyx account that owns the resource, for example f5586561-8ff0-4291-a51b-c7dfe4139ff9. The account_sid path segment is kept for Twilio API compatibility, but the value is a Telnyx account UUID, not a Twilio AC... SID. It must match the account that owns the API key used to authenticate the request, otherwise the endpoint returns 404. The same value is sent as AccountSid in TeXML webhooks.

Example:

"f5586561-8ff0-4291-a51b-c7dfe4139ff9"

Query Parameters

Page

integer

The number of the page to be displayed, zero-indexed, should be used in conjuction with PageToken.

PageSize

integer

The number of records to be displayed on a page

PageToken

string

Used to request the next page of results.

string

Filters calls by the to number.

From

string

Filters calls by the from number.

Status

enum<string>

Filters calls by status.

Available options:

canceled,

completed,

failed,

busy,

no-answer

StartTime

string

Filters calls by their start date. Expected format is YYYY-MM-DD.

StartTime>

string

Filters calls by their start date (after). Expected format is YYYY-MM-DD

StartTime<

string

Filters calls by their start date (before). Expected format is YYYY-MM-DD

EndTime

string

Filters calls by their end date. Expected format is YYYY-MM-DD

EndTime>

string

Filters calls by their end date (after). Expected format is YYYY-MM-DD

EndTime<

string

Filters calls by their end date (before). Expected format is YYYY-MM-DD

Response

Multiple call resources.

calls

Call resource · object[]

Show child attributes

end

integer

The number of the last element on the page, zero-indexed.

Example:

19

first_page_uri

string

/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls.json?Page=0&PageSize=1

Example:

"accepted"

next_page_uri

string

/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls.json?Page=1&PageSize=1&PageToken=MTY4AjgyNDkwNzIxMQ

Example:

"accepted"

page

integer

Current page number, zero-indexed.

Example:

0

page_size

integer

The number of items on the page

Example:

20

start

integer

The number of the first element on the page, zero-indexed.

Example:

0

uri

string

The URI of the current page.

Example:

"/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls.json?Page=0&PageSize=1"

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const response = await client.texml.accounts.calls.retrieveCalls('account_sid');

console.log(response.calls);

import os
from telnyx import Telnyx

client = Telnyx(
    api_key=os.environ.get("TELNYX_API_KEY"),  # This is the default and can be omitted
)
response = client.texml.accounts.calls.retrieve_calls(
    account_sid="account_sid",
)
print(response.calls)

package main

import (
	"context"
	"fmt"

	"github.com/team-telnyx/telnyx-go"
	"github.com/team-telnyx/telnyx-go/option"
)

func main() {
	client := telnyx.NewClient(
		option.WithAPIKey("My API Key"),
	)
	response, err := client.Texml.Accounts.Calls.GetCalls(
		context.TODO(),
		"account_sid",
		telnyx.TexmlAccountCallGetCallsParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", response.Calls)
}

package com.telnyx.sdk.example;

import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
import com.telnyx.sdk.models.texml.accounts.calls.CallRetrieveCallsParams;
import com.telnyx.sdk.models.texml.accounts.calls.CallRetrieveCallsResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        TelnyxClient client = TelnyxOkHttpClient.fromEnv();

        CallRetrieveCallsResponse response = client.texml().accounts().calls().retrieveCalls("account_sid");
    }
}

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Telnyx\Client;
use Telnyx\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');

try {
  $response = $client->texml->accounts->calls->retrieveCalls(
    'account_sid',
    endTime: 'EndTime',
    endTimeGt: 'EndTime_gt',
    endTimeLt: 'EndTime_lt',
    from: 'From',
    page: 0,
    pageSize: 0,
    pageToken: 'PageToken',
    startTime: 'StartTime',
    startTimeGt: 'StartTime_gt',
    startTimeLt: 'StartTime_lt',
    status: 'canceled',
    to: 'To',
  );

  var_dump($response);
} catch (APIException $e) {
  echo $e->getMessage();
}

{
  "calls": [],
  "end": 0,
  "first_page_uri": "/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls.json?Page=0&PageSize=1",
  "next_page_uri": "/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls.json?Page=1&PageSize=1&PageToken=MTY4AjgyNDkwNzIxMQ",
  "page": 0,
  "page_size": 1,
  "start": 0,
  "uri": "/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls.json?Page=0&PageSize=1"
}

{
  "errors": [
    {
      "detail": "Resource not found"
    }
  ]
}

Guides

Markup Language

API Reference

For AI Agents

Fetch multiple call resources

Authorizations

Path Parameters

Query Parameters

Response