Skip to main content
GET
Get phone connections
You are reading the docs of Galtea 5.14. Read this page in the latest version.

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"

id
string
Example:

"phoneConnection_123"

userId
string | null
Example:

"user_123"

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