Twilio Programmable Voice

https://www.twilio.com/docs/voice
Admin
Twilio Programmable Voice enables developers to build, manage, and integrate voice applications,...
Tokens:538,225
Snippets:2,090
Trust Score:10
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### Example response for listing ConnectionPolicy resources

Source: https://www.twilio.com/docs/voice/bring-your-own-carrier-byoc/api/connectionpolicy-resource

Example JSON response from the GET /v1/ConnectionPolicies endpoint. Shows the pagination metadata and a single connection_policies object with fields like account_sid, sid, friendly_name, and links to targets.

```json
{
  "meta": {
    "page": 0,
    "page_size": 50,
    "first_page_url": "https://voice.twilio.com/v1/ConnectionPolicies?PageSize=50&Page=0",
    "previous_page_url": null,
    "url": "https://voice.twilio.com/v1/ConnectionPolicies?PageSize=50&Page=0",
    "next_page_url": null,
    "key": "connection_policies"
  },
  "connection_policies": [
    {
      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "sid": "NYaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "friendly_name": "friendly_name",
      "date_created": "2020-03-18T23:31:36Z",
      "date_updated": "2020-03-18T23:31:37Z",
      "url": "https://voice.twilio.com/v1/ConnectionPolicies/NYaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "links": {
        "targets": "https://voice.twilio.com/v1/ConnectionPolicies/NYaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Targets"
      }
    }
  ]
}
```

--------------------------------

### Create a call with status callbacks (C#, Java, Go)

Source: https://www.twilio.com/docs/voice/api/call-resource

Create a new call using the Twilio Voice API with the C#, Java, and Go helper libraries. Each example initializes the client with API key credentials from environment variables, sets the request method to GET, configures status callbacks for 'initiated' and 'answered' events, and prints the returned call SID.

```csharp
// Install the C# / .NET helper library from twilio.com/docs/csharp/install

using System;
using Twilio;
using Twilio.Rest.Api.V2010.Account;
using System.Threading.Tasks;
using System.Collections.Generic;

class Program {
    public static async Task Main(string[] args) {
        // Find your Account SID at twilio.com/console
        // Provision API Keys at twilio.com/console/runtime/api-keys
        // and set the environment variables. See http://twil.io/secure
        // For local testing, you can use your Account SID and Auth token
        string apiKey = Environment.GetEnvironmentVariable("TWILIO_API_KEY");
        string apiSecret = Environment.GetEnvironmentVariable("TWILIO_API_SECRET");
        string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");

        TwilioClient.Init(apiKey, apiSecret, accountSid);

        var call = await CallResource.CreateAsync(
            method: Twilio.Http.HttpMethod.Get,
            statusCallback: new Uri("https://www.myapp.com/events"),
            statusCallbackEvent: new List<string> { "initiated", "answered" },
            statusCallbackMethod: Twilio.Http.HttpMethod.Post,
            url: new Uri("http://demo.twilio.com/docs/voice.xml"),
            to: new Twilio.Types.PhoneNumber("+14155551212"),
            from: new Twilio.Types.PhoneNumber("+18668675310"));

        Console.WriteLine(call.Sid);
    }
}
```

```java
// Install the Java helper library from twilio.com/docs/java/install

import java.net.URI;
import java.util.Arrays;
import com.twilio.Twilio;
import com.twilio.rest.api.v2010.account.Call;
import com.twilio.http.HttpMethod;

public class Example {
    // Find your Account SID at twilio.com/console
    // Provision API Keys at twilio.com/console/runtime/api-keys
    // and set the environment variables. See http://twil.io/secure
    // For local testing, you can use your Account SID and Auth token
    public static final String API_KEY = System.getenv("TWILIO_API_KEY");
    public static final String API_SECRET = System.getenv("TWILIO_API_SECRET");
    public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID");

    public static void main(String[] args) {
        Twilio.init(API_KEY, API_SECRET, ACCOUNT_SID);
        Call call = Call.creator(new com.twilio.type.PhoneNumber("+14155551212"),
                            new com.twilio.type.PhoneNumber("+18668675310"),
                            URI.create("http://demo.twilio.com/docs/voice.xml"))
                        .setMethod(HttpMethod.GET)
                        .setStatusCallback(URI.create("https://www.myapp.com/events"))
                        .setStatusCallbackEvent(Arrays.asList("initiated", "answered"))
                        .setStatusCallbackMethod(HttpMethod.POST)
                        .create();

        System.out.println(call.getSid());
    }
}
```

```go
// Download the helper library from https://www.twilio.com/docs/go/install
package main

import (
	"fmt"
	"github.com/twilio/twilio-go"
	api "github.com/twilio/twilio-go/rest/api/v2010"
	"os"
)

func main() {
	// Find your Account SID at twilio.com/console
	// Provision API Keys at twilio.com/console/runtime/api-keys
	// and set the environment variables. See http://twil.io/secure
	// For local testing, you can use your Account SID and Auth token
	accountSid := os.Getenv("TWILIO_ACCOUNT_SID")
	apiKey := os.Getenv("TWILIO_API_KEY")
	apiSecret := os.Getenv("TWILIO_API_SECRET")
	client := twilio.NewRestClientWithParams(twilio.ClientParams{
		Username:   apiKey,
		Password:   apiSecret,
		AccountSid: accountSid,
	})

	params := &api.CreateCallParams{}
	params.SetMethod("GET")
	params.SetStatusCallback("https://www.myapp.com/events")
	params.SetStatusCallbackEvent([]string{
		"initiated",
		"answered",
	})
	params.SetStatusCallbackMethod("POST")
	params.SetUrl("http://demo.twilio.com/docs/voice.xml")
	params.SetTo("+14155551212")
	params.SetFrom("+18668675310")

	resp, err := client.Api.CreateCall(params)
	if err != nil {
		fmt.Println(err.Error())
		os.Exit(1)
	} else {
		if resp.Sid != nil {
			fmt.Println(*resp.Sid)
		} else {
			fmt.Println(resp.Sid)
		}
	}
}
```

--------------------------------

### GET https://voice.twilio.com/v1/ByocTrunks

Source: https://www.twilio.com/docs/voice/bring-your-own-carrier-byoc/api/byoctrunk-resource

This snippet documents the GET endpoint for listing multiple ByocTrunk resources. It includes query parameters, response structure, and an example response.

```APIDOC
## GET https://voice.twilio.com/v1/ByocTrunks

### Description
Lists multiple ByocTrunk resources. This endpoint returns a paginated list of BYOC Trunks associated with the account.

### Method
GET

### Endpoint
https://voice.twilio.com/v1/ByocTrunks

### Parameters
#### Query Parameters
- **pageSize** (integer<int64>) - Optional - How many resources to return in each list page. The default is 50, and the maximum is 1000. Minimum: `1`, Maximum: `1000`.
- **page** (integer) - Optional - The page index. This value is simply for client state. Minimum: `0`.
- **pageToken** (string) - Optional - The page token. This is provided by the API.

### Request Example
No request body is required for this GET request.

### Response
#### Success Response (200)
- **meta** (object) - Pagination metadata including page, page_size, first_page_url, previous_page_url, url, next_page_url, and key.
- **byoc_trunks** (array) - List of ByocTrunk resources. Each resource contains:
  - **account_sid** (string) - The SID of the Account that created the resource.
  - **sid** (string) - The unique string that identifies the resource.
  - **friendly_name** (string) - The string that you assigned to describe the resource.
  - **voice_url** (string) - The URL we call using the voice_method when the BYOC Trunk receives a call.
  - **voice_method** (string) - The HTTP method we use to call voice_url.
  - **voice_fallback_method** (string) - The HTTP method we use to call voice_fallback_url.
  - **voice_fallback_url** (string) - The URL that we call when an error occurs while retrieving or executing the TwiML requested by voice_url.
  - **status_callback_method** (string) - The HTTP method we use to call status_callback_url.
  - **status_callback_url** (string) - The URL that we call to pass status parameters to your application.
  - **cnam_lookup_enabled** (boolean) - Whether Caller ID Name (CNAM) lookup is enabled for the trunk.
  - **connection_policy_sid** (string) - The SID of the Connection Policy that is used when routing traffic through the BYOC Trunk.
  - **from_domain_sid** (string) - The SID of the SIP Domain that should be used in the From header of the SIP requests sent to your carrier.
  - **date_created** (string) - The RFC 2822 date and time in GMT when the resource was created.
  - **date_updated** (string) - The RFC 2822 date and time in GMT when the resource was last updated.
  - **url** (string) - The absolute URL of the resource.

#### Response Example
```json
{
  "meta": {
    "page": 0,
    "page_size": 50,
    "first_page_url": "https://voice.twilio.com/v1/ByocTrunks?PageSize=50&Page=0",
    "previous_page_url": null,
    "url": "https://voice.twilio.com/v1/ByocTrunks?PageSize=50&Page=0",
    "next_page_url": null,
    "key": "byoc_trunks"
  },
  "byoc_trunks": [
    {
      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "sid": "BYaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "friendly_name": "friendly_name",
      "voice_url": "https://byoc.example.com/twilio/app",
      "voice_method": "POST",
      "voice_fallback_method": "POST",
      "voice_fallback_url": "https://byoc.example.com/twilio/fallback",
      "status_callback_method": "POST",
      "status_callback_url": "https://byoc.example.com/twilio/status_callback",
      "cnam_lookup_enabled": false,
      "connection_policy_sid": "NYaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "from_domain_sid": "SDaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "date_created": "2020-03-18T23:31:36Z",
      "date_updated": "2020-03-18T23:31:37Z",
      "url": "https://voice.twilio.com/v1/ByocTrunks/BYaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    }
  ]
}
```
```

--------------------------------

### Create Queue with C# / .NET

Source: https://www.twilio.com/docs/voice/api/queue-resource

C# / .NET example using the Twilio helper library to create a queue. Requires TWILIO_API_KEY, TWILIO_API_SECRET, and TWILIO_ACCOUNT_SID environment variables. Prints the queue's DateUpdated.

```csharp
// Install the C# / .NET helper library from twilio.com/docs/csharp/install

using System;
using Twilio;
using Twilio.Rest.Api.V2010.Account;
using System.Threading.Tasks;

class Program {
    public static async Task Main(string[] args) {
        // Find your Account SID at twilio.com/console
        // Provision API Keys at twilio.com/console/runtime/api-keys
        // and set the environment variables. See http://twil.io/secure
        // For local testing, you can use your Account SID and Auth token
        string apiKey = Environment.GetEnvironmentVariable("TWILIO_API_KEY");
        string apiSecret = Environment.GetEnvironmentVariable("TWILIO_API_SECRET");
        string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");

        TwilioClient.Init(apiKey, apiSecret, accountSid);

        var queue = await QueueResource.CreateAsync(friendlyName: "FriendlyName");

        Console.WriteLine(queue.DateUpdated);
    }
}
```

--------------------------------

### GET https://voice.twilio.com/v1/IpRecords

Source: https://www.twilio.com/docs/voice/bring-your-own-carrier-byoc/api/iprecord-resource

This snippet documents the GET endpoint for listing multiple IpRecord resources. It includes query parameters, response structure, and an example response.

```APIDOC
## GET https://voice.twilio.com/v1/IpRecords

### Description
Read multiple IpRecord resources. This endpoint returns a list of IP records associated with the account.

### Method
GET

### Endpoint
https://voice.twilio.com/v1/IpRecords

### Parameters
#### Query Parameters
- **pageSize** (integer<int64>) - Optional - How many resources to return in each list page. The default is 50, and the maximum is 1000. Minimum: `1`, Maximum: `1000`.
- **page** (integer) - Optional - The page index. This value is simply for client state. Minimum: `0`.
- **pageToken** (string) - Optional - The page token. This is provided by the API.

### Request Example
No request body is required for this GET request.

### Response
#### Success Response (200)
- **meta** (object) - Pagination metadata including page, page_size, first_page_url, previous_page_url, url, next_page_url, and key.
- **ip_records** (array) - List of IP record objects. Each object contains account_sid, sid, friendly_name, ip_address, cidr_prefix_length, date_created, date_updated, and url.

#### Response Example
```json
{
  "meta": {
    "page": 0,
    "page_size": 50,
    "first_page_url": "https://voice.twilio.com/v1/IpRecords?PageSize=50&Page=0",
    "previous_page_url": null,
    "url": "https://voice.twilio.com/v1/IpRecords?PageSize=50&Page=0",
    "next_page_url": null,
    "key": "ip_records"
  },
  "ip_records": [
    {
      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "sid": "ILaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "friendly_name": "friendly_name",
      "ip_address": "10.2.3.4",
      "cidr_prefix_length": 30,
      "date_created": "2020-03-18T23:31:36Z",
      "date_updated": "2020-03-18T23:31:37Z",
      "url": "https://voice.twilio.com/v1/IpRecords/ILaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    }
  ]
}
```
```

--------------------------------

### List Queues with Java

Source: https://www.twilio.com/docs/voice/api/queue-resource

Java helper library example to list Queues. Uses API key and secret environment variables, and prints the 'getEnd()' property of each queue.

```java
// Install the Java helper library from twilio.com/docs/java/install

import com.twilio.Twilio;
import com.twilio.rest.api.v2010.account.Queue;
import com.twilio.base.ResourceSet;

public class Example {
    // Find your Account SID at twilio.com/console
    // Provision API Keys at twilio.com/console/runtime/api-keys
    // and set the environment variables. See http://twil.io/secure
    // For local testing, you can use your Account SID and Auth token
    public static final String API_KEY = System.getenv("TWILIO_API_KEY");
    public static final String API_SECRET = System.getenv("TWILIO_API_SECRET");
    public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID");

    public static void main(String[] args) {
        Twilio.init(API_KEY, API_SECRET, ACCOUNT_SID);
        ResourceSet<Queue> queues = Queue.reader().limit(20).read();

        for (Queue record : queues) {
            System.out.println(record.getEnd());
        }
    }
}
```

--------------------------------

### Fetch Queue with C# / .NET

Source: https://www.twilio.com/docs/voice/api/queue-resource

C# / .NET example using the Twilio helper library to fetch a Queue by its Sid. Requires TWILIO_ACCOUNT_SID, TWILIO_API_KEY, and TWILIO_API_SECRET environment variables. Prints the queue's DateUpdated.

```csharp
// Install the C# / .NET helper library from twilio.com/docs/csharp/install

using System;
using Twilio;
using Twilio.Rest.Api.V2010.Account;
using System.Threading.Tasks;

class Program {
    public static async Task Main(string[] args) {
        // Find your Account SID at twilio.com/console
        // Provision API Keys at twilio.com/console/runtime/api-keys
        // and set the environment variables. See http://twil.io/secure
        // For local testing, you can use your Account SID and Auth token
        string apiKey = Environment.GetEnvironmentVariable("TWILIO_API_KEY");
        string apiSecret = Environment.GetEnvironmentVariable("TWILIO_API_SECRET");
        string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");

        TwilioClient.Init(apiKey, apiSecret, accountSid);

        var queue = await QueueResource.FetchAsync(pathSid: "QUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa");

        Console.WriteLine(queue.DateUpdated);
    }
}
```

--------------------------------

### Start SIPREC with status callback via TwiML

Source: https://www.twilio.com/docs/voice/api/siprec

Use this TwiML inside a <Start> verb to start a SIPREC session with a status callback. The statusCallback URL receives SIPREC session status updates via the specified method (GET).

```xml
<Start>
<Siprec name="my-first-siprec" connectorName="Gridspace1" statusCallback="https://87b252436d40.ngrok.app" statusCallbackMethod="GET"/>
</Start>
```

--------------------------------

### List Calls with Twilio helper libraries (JavaScript, Python, C#, Java, Go)

Source: https://www.twilio.com/docs/voice/api/call-resource

Retrieve a list of Calls using the Twilio helper libraries. Each example initializes the client with API key credentials from environment variables and lists up to 20 calls, printing the 'end' property of each call. The Go example includes error handling and exits on failure.

```javascript
// Download the helper library from https://www.twilio.com/docs/node/install
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";

// Find your Account SID at twilio.com/console
// Provision API Keys at twilio.com/console/runtime/api-keys
// and set the environment variables. See http://twil.io/secure
// For local testing, you can use your Account SID and Auth token
const accountSid = process.env.TWILIO_ACCOUNT_SID;
const apiKey = process.env.TWILIO_API_KEY;
const apiSecret = process.env.TWILIO_API_SECRET;
const client = twilio(apiKey, apiSecret, { accountSid: accountSid });

async function listCall() {
  const calls = await client.calls.list({ limit: 20 });

  calls.forEach((c) => console.log(c.end));
}

listCall();
```

```python
# Download the helper library from https://www.twilio.com/docs/python/install
import os
from twilio.rest import Client

# Find your Account SID at twilio.com/console
# Provision API Keys at twilio.com/console/runtime/api-keys
# and set the environment variables. See http://twil.io/secure
# For local testing, you can use your Account SID and Auth token
api_key = os.environ["TWILIO_API_KEY"]
api_secret = os.environ["TWILIO_API_SECRET"]
account_sid = os.environ["TWILIO_ACCOUNT_SID"]
client = Client(api_key, api_secret, account_sid)

calls = client.calls.list(limit=20)

for record in calls:
    print(record.end)
```

```csharp
// Install the C# / .NET helper library from twilio.com/docs/csharp/install

using System;
using Twilio;
using Twilio.Rest.Api.V2010.Account;
using System.Threading.Tasks;

class Program {
    public static async Task Main(string[] args) {
        // Find your Account SID at twilio.com/console
        // Provision API Keys at twilio.com/console/runtime/api-keys
        // and set the environment variables. See http://twil.io/secure
        // For local testing, you can use your Account SID and Auth token
        string apiKey = Environment.GetEnvironmentVariable("TWILIO_API_KEY");
        string apiSecret = Environment.GetEnvironmentVariable("TWILIO_API_SECRET");
        string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");

        TwilioClient.Init(apiKey, apiSecret, accountSid);

        var calls = await CallResource.ReadAsync(limit: 20);

        foreach (var record in calls) {
            Console.WriteLine(record.End);
        }
    }
}
```

```java
// Install the Java helper library from twilio.com/docs/java/install

import com.twilio.Twilio;
import com.twilio.rest.api.v2010.account.Call;
import com.twilio.base.ResourceSet;

public class Example {
    // Find your Account SID at twilio.com/console
    // Provision API Keys at twilio.com/console/runtime/api-keys
    // and set the environment variables. See http://twil.io/secure
    // For local testing, you can use your Account SID and Auth token
    public static final String API_KEY = System.getenv("TWILIO_API_KEY");
    public static final String API_SECRET = System.getenv("TWILIO_API_SECRET");
    public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID");

    public static void main(String[] args) {
        Twilio.init(API_KEY, API_SECRET, ACCOUNT_SID);
        ResourceSet<Call> calls = Call.reader().limit(20).read();

        for (Call record : calls) {
            System.out.println(record.getEnd());
        }
    }
}
```

```go
// Download the helper library from https://www.twilio.com/docs/go/install
package main

import (
	"fmt"
	"github.com/twilio/twilio-go"
	api "github.com/twilio/twilio-go/rest/api/v2010"
	"os"
)

func main() {
	// Find your Account SID at twilio.com/console
	// Provision API Keys at twilio.com/console/runtime/api-keys
	// and set the environment variables. See http://twil.io/secure
	// For local testing, you can use your Account SID and Auth token
	accountSid := os.Getenv("TWILIO_ACCOUNT_SID")
	apiKey := os.Getenv("TWILIO_API_KEY")
	apiSecret := os.Getenv("TWILIO_API_SECRET")
	client := twilio.NewRestClientWithParams(twilio.ClientParams{
		Username:   apiKey,
		Password:   apiSecret,
		AccountSid: accountSid,
	})

	params := &api.ListCallParams{}
	params.SetLimit(20)

	resp, err := client.Api.ListCall(params)
	if err != nil {
		fmt.Println(err.Error())
		os.Exit(1)
	} else {
		for record := range resp {
			if resp[record].End != nil {
				fmt.Println(*resp[record].End)
			} else {
				fmt.Println(resp[record].End)
			}
		}
	}
}
```

--------------------------------

### GET /2010-04-01/Accounts/{AccountSid}/Calls.json

Source: https://www.twilio.com/docs/voice/api/call-resource

Retrieve a list of Calls and filter by start date.

```APIDOC
## GET /2010-04-01/Accounts/{AccountSid}/Calls.json

### Description
Retrieve a list of Calls and filter by start date.

### Method
GET

### Endpoint
/2010-04-01/Accounts/{AccountSid}/Calls.json

### Parameters
#### Query Parameters
- **Status** (string) - Optional - The status of the calls to retrieve (e.g., completed).
- **To** (string) - Optional - The destination phone number to filter calls.
- **From** (string) - Optional - The caller phone number to filter calls.
- **StartTime** (string) - Optional - The start date to filter calls (e.g., 2008-01-02).
- **ParentCallSid** (string) - Optional - The SID of the parent call to filter.
- **EndTime** (string) - Optional - The end date to filter calls.
- **PageSize** (integer) - Optional - The number of records per page.
- **Page** (integer) - Optional - The page number to retrieve.

### Request Example
GET /2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls.json?Status=completed&To=%2B123456789&From=%2B987654321&StartTime=2008-01-02&ParentCallSid=CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&EndTime=2009-01-02&PageSize=2&Page=0

### Response
#### Success Response (200)
- **calls** (array) - List of Call resources.
- **end** (integer) - The end index of the page.
- **first_page_uri** (string) - URI for the first page.
- **next_page_uri** (string) - URI for the next page.
- **page** (integer) - The current page number.
- **page_size** (integer) - The number of records per page.
- **previous_page_uri** (string) - URI for the previous page.
- **start** (integer) - The start index of the page.
- **uri** (string) - The URI of the current page.

#### Response Example
{
  "calls": [
    {
      "subresource_uris": {
        "notifications": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa0/Notifications.json",
        "recordings": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa0/Recordings.json",
        "payments": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa0/Payments.json",
        "events": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa0/Events.json",
        "siprec": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa0/Siprec.json",
        "streams": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa0/Streams.json",
        "transcriptions": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa0/Transcriptions.json",
        "user_defined_message_subscriptions": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa0/UserDefinedMessageSubscriptions.json",
        "user_defined_messages": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa0/UserDefinedMessages.json"
      },
      "to": "+13051913580",
      "to_formatted": "(305) 191-3580",
      "trunk_sid": "TKdeadbeefdeadbeefdeadbeefdeadbeef",
      "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa0.json",
      "queue_time": "1000"
    }
  ],
  "end": 1,
  "first_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls.json?Status=completed&To=%2B123456789&From=%2B987654321&StartTime=2008-01-02&ParentCallSid=CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&EndTime=2009-01-02&PageSize=2&Page=0",
  "next_page_uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls.json?Status=completed&To=%2B123456789&From=%2B987654321&StartTime=2008-01-02&ParentCallSid=CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&EndTime=2009-01-02&PageSize=2&Page=1&PageToken=PACAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa0",
  "page": 0,
  "page_size": 2,
  "previous_page_uri": null,
  "start": 0,
  "uri": "/2010-04-01/Accounts/ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Calls.json?Status=completed&To=%2B123456789&From=%2B987654321&StartTime=2008-01-02&ParentCallSid=CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&EndTime=2009-01-02&PageSize=2&Page=0"
}
```

--------------------------------

### List Trust Products with Node.js

Source: https://www.twilio.com/docs/voice/brand-your-calls-using-cnam

Node.js example to list Trust Products using the Twilio helper library. Requires TWILIO_ACCOUNT_SID, TWILIO_API_KEY, and TWILIO_API_SECRET environment variables. Outputs the SIDs of the first 20 trust products.

```javascript
// Download the helper library from https://www.twilio.com/docs/node/install
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";

// Find your Account SID at twilio.com/console
// Provision API Keys at twilio.com/console/runtime/api-keys
// and set the environment variables. See http://twil.io/secure
// For local testing, you can use your Account SID and Auth token
const accountSid = process.env.TWILIO_ACCOUNT_SID;
const apiKey = process.env.TWILIO_API_KEY;
const apiSecret = process.env.TWILIO_API_SECRET;
const client = twilio(apiKey, apiSecret, { accountSid: accountSid });

async function listTrustProduct() {
  const trustProducts = await client.trusthub.v1.trustProducts.list({
    limit: 20,
  });

  trustProducts.forEach((t) => console.log(t.sid));
}
```

--------------------------------

### GET /2010-04-01/Accounts/{AccountSid}/Transcriptions.json

Source: https://www.twilio.com/docs/voice/api/recording-transcription

This snippet documents the GET endpoint for retrieving a list of Transcriptions from the Twilio API, including path and query parameters and code examples in multiple languages.

```APIDOC
## GET /2010-04-01/Accounts/{AccountSid}/Transcriptions.json

### Description
Returns a list of Transcriptions generated from all recordings in an account. The response contains a paginated list.

### Method
GET

### Endpoint
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Transcriptions.json

### Parameters
#### Path Parameters
- **AccountSid** (string) - Required - The SID of the Account that created the Transcription resources to read. Must match pattern ^AC[0-9a-fA-F]{32}$ and be 34 characters long.

#### Query Parameters
- **PageSize** (integer) - Optional - How many resources to return in each list page. The default is 50, and the maximum is 1000.
- **Page** (integer) - Optional - The page index. This value is simply for client state.
- **PageToken** (string) - Optional - The page token. This is provided by the API.

### Response
#### Success Response (200)
Returns a paginated list of Transcription resources.

### Code Examples

#### Node.js
```js
// Download the helper library from https://www.twilio.com/docs/node/install
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";

// Find your Account SID at twilio.com/console
// Provision API Keys at twilio.com/console/runtime/api-keys
// and set the environment variables. See http://twil.io/secure
// For local testing, you can use your Account SID and Auth token
const accountSid = process.env.TWILIO_ACCOUNT_SID;
const apiKey = process.env.TWILIO_API_KEY;
const apiSecret = process.env.TWILIO_API_SECRET;
const client = twilio(apiKey, apiSecret, { accountSid: accountSid });

async function listTranscription() {
  const transcriptions = await client.transcriptions.list({ limit: 20 });

  transcriptions.forEach((t) => console.log(t.end));
}

listTranscription();
```

#### Python
```python
# Download the helper library from https://www.twilio.com/docs/python/install
import os
from twilio.rest import Client

# Find your Account SID at twilio.com/console
# Provision API Keys at twilio.com/console/runtime/api-keys
# and set the environment variables. See http://twil.io/secure
# For local testing, you can use your Account SID and Auth token
api_key = os.environ["TWILIO_API_KEY"]
api_secret = os.environ["TWILIO_API_SECRET"]
account_sid = os.environ["TWILIO_ACCOUNT_SID"]
client = Client(api_key, api_secret, account_sid)

transcriptions = client.transcriptions.list(limit=20)

for record in transcriptions:
    print(record.end)
```

#### C#
```csharp
// Install the C# / .NET helper library from twilio.com/docs/csharp/install

using System;
using Twilio;
using Twilio.Rest.Api.V2010.Account;
using System.Threading.Tasks;

class Program {
    public static async Task Main(string[] args) {
        // Find your Account SID at twilio.com/console
        // Provision API Keys at twilio.com/console/runtime/api-keys
        // and set the environment variables. See http://twil.io/secure
        // For local testing, you can use your Account SID and Auth token
        string apiKey = Environment.GetEnvironmentVariable("TWILIO_API_KEY");
        string apiSecret = Environment.GetEnvironmentVariable("TWILIO_API_SECRET");
        string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");

        TwilioClient.Init(apiKey, apiSecret, accountSid);

        var transcriptions = await TranscriptionResource.ReadAsync(limit: 20);

        foreach (var record in transcriptions) {
            Console.WriteLine(record.End);
        }
    }
}
```

#### Java
```java
// Install the Java helper library from twilio.com/docs/java/install

import com.twilio.Twilio;
import com.twilio.rest.api.v2010.account.Transcription;
import com.twilio.base.ResourceSet;

public class Example {
    // Find your Account SID at twilio.com/console
    // Provision API Keys at twilio.com/console/runtime/api-keys
    // and set the environment variables. See http://twil.io/secure
    // For local testing, you can use your Account SID and Auth token
    public static final String API_KEY = System.getenv("TWILIO_API_KEY");
    public static final String API_SECRET = System.getenv("TWILIO_API_SECRET");
    public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID");

    public static void main(String[] args) {
        Twilio.init(API_KEY, API_SECRET, ACCOUNT_SID);
        ResourceSet<Transcription> transcriptions = Transcription.reader().limit(20).read();

        for (Transcription record : transcriptions) {
            System.out.println(record.getEnd());
        }
    }
}
```
```

--------------------------------

### List queues with Twilio helper libraries (Go, PHP, Ruby)

Source: https://www.twilio.com/docs/voice/api/queue-resource

Lists queues using the Twilio helper libraries for Go, PHP, and Ruby. Each example sets a limit of 20 records and prints the 'end' field for each queue. Requires Twilio API credentials set as environment variables (TWILIO_API_KEY, TWILIO_API_SECRET, TWILIO_ACCOUNT_SID).

```go
// Download the helper library from https://www.twilio.com/docs/go/install
package main

import (
	"fmt"
	"github.com/twilio/twilio-go"
	api "github.com/twilio/twilio-go/rest/api/v2010"
	"os"
)

func main() {
	// Find your Account SID at twilio.com/console
	// Provision API Keys at twilio.com/console/runtime/api-keys
	// and set the environment variables. See http://twil.io/secure
	// For local testing, you can use your Account SID and Auth token
	accountSid := os.Getenv("TWILIO_ACCOUNT_SID")
	apiKey := os.Getenv("TWILIO_API_KEY")
	apiSecret := os.Getenv("TWILIO_API_SECRET")
	client := twilio.NewRestClientWithParams(twilio.ClientParams{
		Username:   apiKey,
		Password:   apiSecret,
		AccountSid: accountSid,
	})

	params := &api.ListQueueParams{}
	params.SetLimit(20)

	resp, err := client.Api.ListQueue(params)
	if err != nil {
		fmt.Println(err.Error())
		os.Exit(1)
	} else {
		for record := range resp {
			if resp[record].End != nil {
				fmt.Println(*resp[record].End)
			} else {
				fmt.Println(resp[record].End)
			}
		}
	}
}
```

```php
<?php

// Update the path below to your autoload.php,
// see https://getcomposer.org/doc/01-basic-usage.md
require_once "/path/to/vendor/autoload.php";

use Twilio\Rest\Client;

// Find your Account SID at twilio.com/console
// Provision API Keys at twilio.com/console/runtime/api-keys
// and set the environment variables. See http://twil.io/secure
// For local testing, you can use your Account SID and Auth token
$apiKey = $_ENV["TWILIO_API_KEY"];
$apiSecret = $_ENV["TWILIO_API_SECRET"];
$sid = $_ENV["TWILIO_ACCOUNT_SID"];
$twilio = new Client($apiKey, $apiSecret, $sid);

$queues = $twilio->queues->read(20);

foreach ($queues as $record) {
    print $record->end;
}
```

```ruby
# Download the helper library from https://www.twilio.com/docs/ruby/install
require 'twilio-ruby'

# Find your Account SID at twilio.com/console
# Provision API Keys at twilio.com/console/runtime/api-keys
# and set the environment variables. See http://twil.io/secure
# For local testing, you can use your Account SID and Auth token
api_key = ENV['TWILIO_API_KEY']
api_secret = ENV['TWILIO_API_SECRET']
account_sid = ENV['TWILIO_ACCOUNT_SID']
@client = Twilio::REST::Client.new(api_key, api_secret, account_sid)

queues = @client
         .api
         .v2010
         .queues
         .list(limit: 20)

queues.each do |record|
   puts record.end
end
```

--------------------------------

### GET /2010-04-01/Accounts/{AccountSid}/Calls.json

Source: https://www.twilio.com/docs/voice/api/call-resource

This snippet documents the HTTP GET endpoint for listing Call resources, including query parameters for filtering by status and start time, and the response structure.

```APIDOC
## GET /2010-04-01/Accounts/{AccountSid}/Calls.json

### Description
Retrieves a list of Call resources for the specified account, optionally filtered by status and start time.

### Method
GET

### Endpoint
`/2010-04-01/Accounts/{AccountSid}/Calls.json`

### Parameters
#### Query Parameters
- **Status** (string) - Optional - The status of the calls to retrieve. Example: `in-progress`.
- **StartTime** (string) - Optional - Filters calls by start time. Use `<=` for before and `>=` for after. Example: `2009-07-06T00:00:00Z`.
- **PageSize** (integer) - Optional - The number of records to return per page. Example: `20`.

### Request Example
```
curl -X GET "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/Calls.json?Status=in-progress&StartTime<=2009-07-06T00:00:00Z&StartTime>=2009-07-04T00:00:00Z&PageSize=20" \
-u $TWILIO_API_KEY:$TWILIO_API_SECRET
```

### Response
#### Success Response (200)
- **calls** (array) - A list of Call resources.
  - **account_sid** (string) - The SID of the account that created the call.
  - **answered_by** (string) - The device that answered the call.
  - **api_version** (string) - The API version used to make the call.

#### Response Example
```json
{
  "calls": [
    {
      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "answered_by": "machine_start",
      "api_version": "2010-04-01"
    }
  ]
}
```
```

--------------------------------

### Create Queue with Java

Source: https://www.twilio.com/docs/voice/api/queue-resource

Java example using the Twilio helper library to create a queue. Requires TWILIO_API_KEY, TWILIO_API_SECRET, and TWILIO_ACCOUNT_SID environment variables. Prints the queue's getDateUpdated().

```java
// Install the Java helper library from twilio.com/docs/java/install

import com.twilio.Twilio;
import com.twilio.rest.api.v2010.account.Queue;

public class Example {
    // Find your Account SID at twilio.com/console
    // Provision API Keys at twilio.com/console/runtime/api-keys
    // and set the environment variables. See http://twil.io/secure
    // For local testing, you can use your Account SID and Auth token
    public static final String API_KEY = System.getenv("TWILIO_API_KEY");
    public static final String API_SECRET = System.getenv("TWILIO_API_SECRET");
    public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID");

    public static void main(String[] args) {
        Twilio.init(API_KEY, API_SECRET, ACCOUNT_SID);
        Queue queue = Queue.creator("FriendlyName").create();

        System.out.println(queue.getDateUpdated());
    }
}
```
Tokens:
Raw