Skip to main content
GET
Retrieve a contact (legacy — no identity)

Authorizations

Authorization
string
header
required

OptimalDial API key, prefixed od_live_, sent as Authorization: Bearer .... Mint keys in the in-app developer panel; they are scoped to a single organization.

Path Parameters

contact_id
string<uuid>
required

Response

The contact.

id
string<uuid>
required
organization_id
string<uuid>
required
phone
string
required

E.164-normalized phone number (US/CA only).

Example:

"+15551234567"

properties
object
required

Arbitrary extra fields echoed back from creation.

status
enum<string>
required
Available options:
queued,
processing,
completed,
failed,
discarded
credits_charged
integer
required
Required range: x >= 0
created_at
string<date-time>
required
updated_at
string<date-time>
required
optimaldial_status
string | null

The Answer Intent classification — e.g. "Likely Answer", "Likely Voicemail". Populated when status == "completed".

This field is frozen on v1: it keeps returning the Answer Intent value even for contacts processed with OptimalDial Identity, so existing filters keep working. Use /api/v2/contacts for the nine-tier status and the identity band.

error_message
string | null
validation_tier
enum<string>

Validation pricing tier this contact was created with.

Available options:
standard,
max