Skip to main content

Retrieve a number search

GET 
/origination/number_searches/:id

Retrieves the details of an existing number search. Searches expire 15 minutes after creation. Once expired they can no longer be used to create an order.

Searches may include best effort matches in the results. These are numbers that are close to your search terms, but may not be exact matches. Best effort matches will come after exact matches in the results and can be easily distinguished by the value of best_effort being true.

The top-level key any_best_effort is also an indicator of whether there are best effort matches present in the results."

Request

Path Parameters

    id stringrequired

    ID of the number search to retrieve

Responses

200: number

401: Unauthorized

404: Resource not found

Request samples


curl -L 'https://api.telnyx.com/origination/number_searches/:id' \
-H 'Accept: application/json'

Response samples


{
"id": "string",
"search_type": 1,
"limit": 10,
"search_descriptor": {},
"status": 1,
"any_best_effort": false,
"result": [
{}
]
}