Phone Numbers API

The Phone Numbers API allows you to manage phone numbers for your Flireo AI assistants. You can list your numbers, search for available numbers, order new ones, and track your orders.

Endpoints Overview

Endpoint	Method	Description
`/v1/phone-numbers`	GET	List your phone numbers
`/v1/phone-numbers`	POST	Order a new phone number
`/v1/phone-numbers/available`	GET	Search available numbers
`/v1/phone-number-orders`	GET	List your orders
`/v1/phone-number-orders/{id}`	GET	Get order details

Phone Number Types

Flireo supports three types of phone numbers:

Type	Description	Verification Required
`national`	Dutch 085 numbers, nationwide	No
`mobile`	Dutch mobile numbers	No
`local`	Regional numbers (e.g., 020 for Amsterdam)	Yes

Important: Local numbers require an approved verification group before you can order them.

Credits

Ordering a phone number costs 10 credits. Make sure you have sufficient credits before placing an order.

Quick Start

1. List Your Numbers

2. Search Available Numbers

3. Order a Number

Next:
Learn how to list your phone numbers, search available numbers, or order a number.

Overview

Phone Numbers API#

Endpoints Overview#

Phone Number Types#

Credits#

Quick Start#

1. List Your Numbers#

2. Search Available Numbers#

3. Order a Number#