Skip to content

Phone Numbers REST API

Service: numbering.api.enfonica.com

To call this service, we recommend that you use a supported Enfonica client library. If a client library is not available in your language or framework of choice, or if you need to write your own client, use the following information when you make API requests.

Service endpoint

Phone Numbers has the following service endpoint and all URIs in the Phone Numbers REST API reference are relative to this service endpoint:

  • https://numbering.api.enfonica.com

REST Resource: v1beta1.phoneNumbers

Methods  
search GET /v1beta1/phoneNumbers:search
Searches available phone numbers with the specified filters.

Search returns phone numbers sorted by create_time descending.

The caller must be authenticated.

REST Resource: v1beta1.projects.phoneNumberInstances

Methods  
create POST /v1beta1/{parent}/phoneNumberInstances
Creates a phone number instance. This provisions a phone number against a project.

The caller must have numbering.phoneNumberInstances.create permission on the project.
get GET /v1beta1/{name}
Retrieves a phone number instance identified by the supplied resource name.

The caller must have numbering.phoneNumberInstances.get permission on the project.
list GET /v1beta1/{parent}/phoneNumberInstances
Lists all phone number instances.

List returns phone number instances sorted by create_time descending.

The caller must have numbering.phoneNumberInstances.list permission on the project.
update PATCH /v1beta1/{name}
Updates a phone number instance.

The caller must have numbering.phoneNumberInstances.update permission on the project.
delete DELETE /v1beta1/{name}
Deletes a phone number instance. This disconnects the phone number.

The caller must have numbering.phoneNumberInstances.delete permission on the project.
move POST /v1beta1/{name}:move
Moves the phone number instance to another project.

Warning: moving a phone number instance may cause the current configuration of the phone number instance to stop working. Any connected flows or SIP domains will need to be reconfigured in the destination project. Any programmable handler will need to accept the signing key of the destination project.

The caller must have numbering.phoneNumberInstances.move permission on both the source and destination projects.
splitRange POST /v1beta1/{phone_number_instance}:splitRange
Splits a phone number range into two ranges.

To split a range, you specify how many numbers to keep in this range. These numbers are taken from the start of the range. The remaining numbers will be moved into a new range.

For example, if you have a range +61255501100-99 and you split it with a size of 20, then: - the original range will be modified to +61255501100-19 (size 20) - a new range will be created with +61255501120-99 (size 80)

The caller must have numbering.phoneNumberInstances.splitRange permission on the project.

REST Resource: v1beta1.projects.regulatoryListings

Methods  
create POST /v1beta1/{parent}/regulatoryListings
Creates a regulatory listing.

By creating a regulatory listing, you acknowledge that the person or entity located at the specified address is the only party that will be utilizing phone numbers associated with this regulatory listing. You acknowledge that Enfonica may process the information provided for the purpose of identity verification, and will share this information with local telecommunications providers or authorities where required by local law. You understand that Enfonica phone numbers may be taken out of service if inaccurate or false information has been provided.

The caller must have numbering.regulatoryListings.create permission on the project.
get GET /v1beta1/{name}
Retrieves a regulatory listing.

The caller must have numbering.regulatoryListings.get permission on the project.
list GET /v1beta1/{parent}/regulatoryListings
Lists all regulatory listings.

List returns regulatory listings sorted by create_time descending.

The caller must have numbering.regulatoryListings.list permission on the project.
update PATCH /v1beta1/{regulatory_listing.name}
Updates a regulatory listing.

The caller must have numbering.regulatoryListings.update permission on the project.
delete DELETE /v1beta1/{name}
Deletes a regulatory listing. Regulatory listings that are associated with an active phone number instance cannot be deleted.

The caller must have numbering.regulatoryListings.delete permission on the project.
search GET /v1beta1/{parent}/regulatoryListings:search
Searches all usable regulatory listings with the specified number type.

List returns regulatory listings sorted by create_time descending.

The caller must have numbering.regulatoryListings.list permission on the project.