Get a phone number | Dial — Communication Stack for AI Agents

Returns the number with its most recent messages and calls.

AuthorizationBearer

Your Dial API key, sent as Authorization: Bearer sk_live_...

idstringRequired

The phone number.

numberobject

401

Unauthorized Error

404

Not Found Error

1	{
2	"number": {
3	"id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
4	"number": "+14155550123",
5	"nickname": "Customer Support",
6	"country": "US",
7	"capabilities": [
8	"sms",
9	"call"
10	],
11	"setupStatus": "ready",
12	"setupError": null,
13	"inboundInstruction": "You are Dial's receptionist. Greet the caller and find out what they need.",
14	"inboundVoiceGender": "female",
15	"inboundLanguage": "es-ES",
16	"accountId": "acc_9876543210",
17	"createdAt": "2024-01-15T09:30:00Z",
18	"maxCallDurationSeconds": 3600
19	}
20	}

$	curl https://api.getdial.ai/api/v1/numbers/id \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"