Get phone connections

[ { "productId": "prod_123", "name": "Support line", "phoneNumber": "+14155552671", "id": "phoneConnection_123", "userId": "user_123", "voice": "jack", "languageCode": "en-US", "agentSpeaksFirst": false, "createdAt": "2023-11-07T05:31:56Z", "deletedAt": "2023-11-07T05:31:56Z" } ]

Authorizations

Authorization

string

header

required

API key authorization. Pass your API key in the Authorization header as a Bearer token. Both new (gsk_*) and legacy (gsk-) API keys are accepted, e.g. Authorization: Bearer gsk_... or Authorization: Bearer gsk-....

Query Parameters

ids

string[]

Filter by phone connection IDs

productIds

string[]

Filter by product IDs

names

string[]

Filter by phone connection names (exact match, multiple)

name

string

Filter by phone connection name (partial match)

phoneNumbers

string[]

Filter by phone numbers (exact match, multiple)

phoneNumber

string

Filter by phone number (partial match)

sort

string[]

Sort instructions (field and direction pairs)

limit

integer

Maximum number of results

offset

integer

Number of results to skip

fromCreatedAt

string<date-time>

Filter phone connections created at or after this timestamp (ISO 8601 format)

toCreatedAt

string<date-time>

Filter phone connections created at or before this timestamp (ISO 8601 format)

Response

Phone connections retrieved successfully

productId

string

required

Example:

"prod_123"

name

string

required

Example:

"Support line"

phoneNumber

string

required

The phone number Galtea dials, in E.164 format.

Example:

"+14155552671"

string

Example:

"phoneConnection_123"

userId

string | null

Example:

"user_123"

voice

string | null

TTS voice the simulated caller speaks with (Speechmatics, English-only). One of sarah (en-GB female), theo (en-GB male), megan (en-US female), jack (en-US male) — fetch the current set from GET /phoneConnections/voices. Leave empty/null to use the default voice (sarah). An unsupported value is rejected with 400.

Example:

"jack"

languageCode

string | null

Optional language code for the telephony agent.

Example:

"en-US"

agentSpeaksFirst

boolean

default:false

Whether the voice agent opens the conversation once the call connects. false (default) means the simulated caller speaks first; true suits interviewer-style agents that greet first.

Example:

false

createdAt

string<date-time>

deletedAt

string<date-time> | null