Search numbers (advanced)

GET 
/api/v2/numbers/search

Advanced search for available DID numbers with multiple filter criteria.

Important notes:

• Supports pagination (page, per_page parameters)
• All filter parameters are optional
• Combine multiple filters for precise results
• Use for complex search scenarios beyond location-based browsing

When to use:

• Implementing vanity number search
• Finding numbers with specific features
• Custom number selection interfaces
• Bulk number lookup

Authentication:

• Requires Bearer token in Authorization header: Authorization: Bearer <token>

Request

Responses

200

returns search results

401

returns unauthorized

403

returns forbidden