Retrieve a number reservation
GET/number_reservations/:number_reservation_id
Gets a single phone number reservation.
Request
Path Parameters
The number reservation ID.
Responses
200: Successful response with details about a number reservation.
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
data
NumberReservation
phone_numbers
ReservedPhoneNumber[]
Possible values: [pending
, success
, failure
]
The status of the phone number's reservation.
An ISO 8901 datetime string denoting when the individual number reservation was created.
An ISO 8901 datetime string for when the the individual number reservation was updated.
An ISO 8901 datetime string for when the individual number reservation is going to expire
Possible values: [pending
, success
, failure
]
The status of the entire reservation.
A customer reference string for customer look ups.
An ISO 8901 datetime string denoting when the numbers reservation was created.
An ISO 8901 datetime string for when the number reservation was updated.
{
"data": {
"id": "12ade33a-21c0-473b-b055-b3c836e1c292",
"record_type": "number_reservation",
"phone_numbers": [
{
"id": "12ade33a-21c0-473b-b055-b3c836e1c292",
"record_type": "reserved_phone_number",
"phone_number": "+19705555098",
"status": "pending",
"created_at": "2018-01-01T00:00:00.000000Z",
"updated_at": "2018-01-01T00:00:00.000000Z",
"expired_at": "2018-01-01T00:00:00.000000Z",
"errors": ""
}
],
"status": "pending",
"customer_reference": "MY REF 001",
"created_at": "2018-01-01T00:00:00.000000Z",
"updated_at": "2018-01-01T00:00:00.000000Z"
}
}
default: Unexpected error
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
errors
Error[]
source
object
JSON pointer (RFC6901) to the offending entity.
Indicates which query parameter caused the error.
meta
object
URL with additional information on the error.
{
"errors": [
{
"code": "10007",
"title": "Unexpected error",
"detail": "An unexpected error occured.",
"source": {
"pointer": "/base",
"parameter": "string"
},
"meta": {
"url": "https://developers.telnyx.com/docs/overview/errors/10015"
}
}
]
}