<Intro>

<EndpointHeader />

<Description>

Returns a single phone number available for purchase, whether it is already in inventory or can be acquired for you. Numbers supplied through a carrier remain available only while the carrier has them, so a number listed a moment ago may already be gone. A `404` means the number is currently unavailable for sale.

</Description>

</Intro>

<Parameters in="path">

<Parameter name="number" type="string">

<Description>

Phone number in E.164 format. The leading `+` is optional.

</Description>

</Parameter>

</Parameters>

<Payload kind="response">

<Field name="number" type="string" required>

<Description>

Phone number in E.164 format.

</Description>

</Field>

<Field name="country_code" type="string" required>

<Description>

ISO 3166-1 alpha-2 country code.

</Description>

</Field>

<Field name="number_type" type="string" required>

<Description>

Physical type of this phone number.

</Description>

</Field>

<Field name="capabilities" type="array of string" required>

<Description>

Channel capabilities supported by this number.

</Description>

</Field>

</Payload>