Error Codes & Statuses

This reference explains statuses and errors you may encounter in Voxifi.

Call Statuses

Call history shows the outcome of each call:

Status	Meaning	Next Steps
queued	Waiting to dial	Wait
ringing	Phone ringing at destination	Wait
in-progress	Call is active	Monitor
completed	Call ended normally	Review transcript and cost
failed	Call did not connect	Check balance and number format
busy	Destination line busy	Retry later
no-answer	No response from recipient	Retry later
canceled	Call was canceled before connecting	N/A

Common Call Errors

Insufficient Balance

What it means: Your account balance is too low to place a call.

Fix: Add funds in Settings → Billing.

Invalid Phone Number

What it means: The destination number is not in a valid format.

Fix: Use E.164 format — a + followed by the country code and number, e.g. +15551234567.

No Phone Number Assigned

What it means: The call does not have a "from" phone number assigned.

Fix: Purchase a phone number and assign it to your AI agent, or select one when placing the call.

Agent Not Found

What it means: The AI agent selected for the call no longer exists or was deleted.

Fix: Select a valid AI agent.

HTTP Status Codes

API responses use standard HTTP status codes:

Code	Meaning	Action
200	Success	Request completed
400	Bad Request	Check request format and required fields
401	Unauthorized	Check authentication — session may have expired
403	Forbidden	You don't have permission for this action
404	Not Found	Verify the resource ID is correct
429	Rate Limited	Slow down requests and retry with backoff
500	Server Error	Retry the request or contact support

Webhook Errors

Connection Failed

Your server could not be reached. Check:

• The URL is correct and uses HTTPS
• Your server is running and publicly accessible
• Firewall rules allow incoming connections on the port

Timeout

Your endpoint did not respond within 30 seconds. Fix:

• Return a 200 response immediately, then process the event asynchronously

Invalid Signature

Webhook signature verification is failing. Check:

• You are using the correct signing secret
• You are verifying against the raw request body
• You are reading the X-Webhook-Signature and X-Webhook-Timestamp headers

4xx Response

Your endpoint is returning a client error (4xx). These are treated as permanent failures and will not be retried (except 429). Fix your endpoint logic and check the delivery log for the response body.

Getting Help

For errors not covered here or persistent issues:

1. Note the full error message
2. Record when it occurred and which call or resource was affected
3. Contact support@voxifi.com