Skip to content
Linq Copy agent prompt

List carrier (BYOC) voice calls for a phone number

client.CallVoice.List(ctx, phoneNumber, query) (*CallVoiceListResponse, error)
GET/v3/phone-numbers/{phoneNumber}/call-voice

List the carrier voice calls received on one of your phone numbers, newest first, with cursor pagination. Each record is the durable form of the call_voice.* webhooks for that call; the id is the same id those webhooks carry. Results are scoped to the authenticated partner — a number that isn’t yours (or simply has no calls) returns 200 with an empty call_voice array, not an error.

ParametersExpand Collapse
phoneNumber string
query CallVoiceListParams
Cursor param.Field[string]Optional

Pagination cursor from a previous next_cursor response

Limit param.Field[int64]Optional

Maximum number of calls to return

minimum1
maximum100
ReturnsExpand Collapse
type CallVoiceListResponse struct{…}
CallVoice []CallVoiceRecord

Calls for the phone number, newest first.

ID string

Stable call id, identical to the id in the call_voice.* webhooks.

formatuuid
Direction CallVoiceRecordDirection
From string

External caller, E.164.

Status CallVoiceRecordStatus

Terminal call outcome. Null while the call is still in progress; set once it ends.

One of the following:
const CallVoiceRecordStatusCompleted CallVoiceRecordStatus = "completed"
const CallVoiceRecordStatusBusy CallVoiceRecordStatus = "busy"
const CallVoiceRecordStatusNoAnswer CallVoiceRecordStatus = "no_answer"
const CallVoiceRecordStatusFailed CallVoiceRecordStatus = "failed"
const CallVoiceRecordStatusCanceled CallVoiceRecordStatus = "canceled"
To string

Your line that was called, E.164.

EndedAt TimeOptional

When the call ended. Null while still in progress.

formatdate-time
StartedAt TimeOptional

When the call was answered. Null if it never connected.

formatdate-time
NextCursor stringOptional

Cursor for the next page of results. Null when there are no more. Pass this value as the cursor parameter in the next request.

List carrier (BYOC) voice calls for a phone number

package main

import (
  "context"
  "fmt"

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

func main() {
  client := linqgo.NewClient(
    option.WithAPIKey("My API Key"),
  )
  callVoices, err := client.CallVoice.List(
    context.TODO(),
    "+14254758217",
    linqgo.CallVoiceListParams{

    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", callVoices.CallVoice)
}
{
  "call_voice": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "direction": "inbound",
      "from": "+12052532136",
      "status": "completed",
      "to": "+12052535597",
      "ended_at": "2026-03-05T12:05:00Z",
      "started_at": "2026-03-05T12:00:05Z"
    }
  ],
  "next_cursor": "next_cursor"
}
{
  "error": {
    "status": 401,
    "code": 2004,
    "message": "Unauthorized - missing or invalid authentication token",
    "doc_url": "https://docs.linqapp.com/channel/imessage/error/codes/2xxx/2004/"
  },
  "success": false
}
{
  "error": {
    "status": 500,
    "code": 3006,
    "message": "Internal server error",
    "doc_url": "https://docs.linqapp.com/channel/imessage/error/codes/3xxx/3006/"
  },
  "success": false
}
Returns Examples
{
  "call_voice": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "direction": "inbound",
      "from": "+12052532136",
      "status": "completed",
      "to": "+12052535597",
      "ended_at": "2026-03-05T12:05:00Z",
      "started_at": "2026-03-05T12:00:05Z"
    }
  ],
  "next_cursor": "next_cursor"
}
{
  "error": {
    "status": 401,
    "code": 2004,
    "message": "Unauthorized - missing or invalid authentication token",
    "doc_url": "https://docs.linqapp.com/channel/imessage/error/codes/2xxx/2004/"
  },
  "success": false
}
{
  "error": {
    "status": 500,
    "code": 3006,
    "message": "Internal server error",
    "doc_url": "https://docs.linqapp.com/channel/imessage/error/codes/3xxx/3006/"
  },
  "success": false
}