Our full list of terms and conditions, alongside our acceptable use policy is available below.

Read our terms and conditions

Germany: 100+ Range Allocation

German Regulator Bundesnetzagentur (BNetzA) defines the maximum range sizes for new subscribers in the document ‘Struktur und Ausgestaltung des Nummernbereichs für Ortsnetzrufnummern‘.

A German and an English version are available on the homepage of BnetzA:

1. Bestimmung der Anzahl zuzuteilender Rufnummern bei durchwahlfähigen VoIP-Anschlüssen
2. http://www.bundesnetzagentur.de/cln_1431/DE/Sachgebiete/Telekommunikation/Unternehmen_Institutionen/Nummerierung/Rufnummern/ONRufnr/Ortsnetze_Basepage.html?nn=268384

(Struktur und Ausgestaltung des Nummernbereichs für Ortsnetzrufnummern)

3. https://www.bundesnetzagentur.de/EN/Areas/Telecommunications/Companies/NumberManagement/GeographicNumbers/LocalNumbers_Basepage.html?nn=404520

(Structure and configuration of the number range for geographic numbers)

For a block greater than 100, the allocation must be approved by BnetzA before assigning numbers to the end-customer.

Process is as per the following:

• Customer sends the request form to BnetzA
• Official timeline for BnetzA to answer is 3 weeks, but less than 1 week in practice.
• Customer sends the approval to Colt
• Customer can assign the numbers.

It’s the customer’s responsibility to engage with BnetzA and share the confirmation with Colt.

Request form is available below in German/English. It can be filled out in both languages; the other language will be populated automatically.

Austria

There is a private numbering plan in Austria.  When you assign a single main number to an end-customer, the end-customer can configure or add digits/extensions (0-9 or 00-99 or 000-999 or 0000-9999) to the main number in their PBX, as per their needs.  You do not need to inform Colt of the range of extensions/digits when (de/re) activating a number, submitting a port-in order or sending an address update – these transactions require the main number only.  The end-customer’s emergency address is entered and stored at the main number level, and not at the extension level.

France: Hosted customer numbers

There are 2 important Regulatory changes impacting the use of phone numbers in France, which came into effect on 1st January 2023:-

1.            The resale of geographic and location independent numbers for outbound voice services is forbidden

2.            France no longer has 400+ local area codes.  01-05 numbers are available for use throughout mainland France

ARCEP, the Regulator in France, published further information on these changes here: https://www.arcep.fr/uploads/tx_gsavis/22-1583.pdf

If you are reselling Colt numbers to your end-customers under your own brand, then you need to take action to register with ARCEP and obtain your own numbers, which Colt can then host on your behalf.  You can contact your Colt Account Manager to complete the order form to host your number blocks with Colt.  For further information, please refer to these links to the Customer Q&A in English and in French.

Hosting your numbers

When we confirm your own numbers are available to use, you will be able to reserve and (pre)activate your own numbers, update addresses etc.  As a result of the Regulatory changes above you will only need to search for numbers on the basis of the LAC: 01-05 and the LAC extension or search by city will no longer be available - should you need the historical reference, please refer to the Number Coverage file.  Your own numbers will be available in ranges of 1, 10, 100 as requested in your order form.  If you run out of single numbers, then our system will automatically take a range of 10 Free numbers and split this into 10 Free single numbers and similar logic applies if you run out of ranges of 10 etc.  You can also view or query for your Free numbers in France and this enables you to monitor your own inventory and apply to ARCEP for new number blocks in good time – the E2E lead-time is 2-3 months depending on ARCEP, Orange & OLO availability during busy periods.

If you have obtained your own routing/porting prefix in France then you can select this when you port-in a number.

We will return deactivated numbers from your number blocks to your “free” pool of numbers at the end of the quarantine & frozen period.  We will return numbers which were ported-out and which have been cancelled / deactivated by the end-customer into your “free” pool of numbers at the end of the quarantine & frozen period, using our established processes & system integration with APNF.

The responsibility to supply compliance reports or to comply with regulatory audits is yours.  Colt will provide a clear view of your number inventory  - the number status & end-customer data via our APIs & Numbers on Demand which you can use to meet these requests together with your own data. 

Tri-partite agreement with Colt numbers

If you do not have your own numbers from ARCEP yet, then from 21^st January 2023 you are responsible for submitting a tri-partite agreement with every order for new Colt number activations. The tri-partite agreement template can be found in English here and in French here.  You are responsible for filling in your own company details, the numbers being ordered, entering the accurate address details of your end-customer and obtaining the end-customer’s signature. 

France: Introduction of RIO codes for the wider business market

There are some changes to the use of RIO codes in France, which came into effect from 1st December 2023, pursuant to Arcep’s decision no 2022-2148.

A RIO code is a unique identifier associated to a telephone number, which is created when a consumer or small business request a new telephone number in France and its purpose is to facilitate the portability process.  If they wish to move / port numbers to a new operator, then the new operator will request the RIO code provided by the current operator for each single telephone number from the consumer / small business in order to validate that the port order is legitimate and to implement the porting order.  These RIO codes are not yet mandatory in the wider business market but this will gradually change.

The changes are:

1. Colt, as a technical operator, must define a unique RIO code for every:
   1. Colt geographic or location independent number
   2. Geographic or location independent number ported-in to Colt
   3. Geographic or location independent number hosted by Colt on your behalf – this includes both new and ported-in numbers where you have mandated Colt as your OPTA (i.e. where we technically manage the porting of your numbers on your behalf)
2. Colt must make these RIO codes available to you via a secure portal, which is our Numbers on Demand portal and over API and these will be available in our May 2024 release.   Up until the May 2024 release, if you require the RIO code for e.g. a consumer / small business port, then please get in touch with [email protected].

It is not foreseen that RIO codes will be required for number portability in the wider business market until 2025, due to the complexity of inter-operator process & system integration work and pursuant to Arcep’s decision.

In a wider context, if you currently support consumers, we would like to remind you that consumer-specific obligations apply pursuant to the regulations, including the provision of an IVR service through which you provide the RIO code associated to a specific number.

As an operator providing voice services in France, you are responsible for portability to your end-customers and other operators, even where Colt is technically managing portability for you as your OPTA.  Obligations regarding how the RIO codes should be shared with your subscribers apply, as well as other obligations related to portability (i.e. additional information to be provided to your subscribers,  contractual provisions, etc.). Obligations may vary depending on the customer type (business, small business, consumer) and the kind of service you provide (OTT, single-number or multi-number offers, etc.).

For further information please see this decision from ARCEP: https://information.colt.net/hubfs/22-2148_FR_Published%20document_22Mar2023%20en-GB.pdf

The RIO code will be present against each CLI in the Numbers on Demand portal when viewing the ‘Number Details’ and will be returned in the B2B API response (SOAP/HTTPs: getNumberDetails and REST: GET/CLIDetails) as well.

Portugal & Spain: Introduction of CIF/NIF/VAT ID check

In May 2024 we have introduced an external check on the CIF/NIF/VAT ID in Portugal and Spain against the European Commission’s VAT Information Exchange System (VIES). – see: https://europa.eu/youreurope/business/taxation/vat/check-vat-number-vies/index_en.htm.   The reason is to improve the accuracy and validity of orders for new numbers and ports as explained below:

• The VAT ID/CIF is included in the CVP generated by Colt for an end-customer and is highly confidential.  The CVP was introduced by the PT Regulator, Anacom, to give greater security to end-customers.  End-customers must include their CVP in a future port order to prove their request is genuine.
• As requested by the ES Regulator, CNMC, the VAT ID/CIF/NIF must be uploaded into the emergency database in Spain and be an exact match to the registered end-customer name.

In Numbers on Demand portal you will see the extra validation step on the CIF/NIF/VAT ID in Portugal & Spain when activating a number, porting-in a number and updating an end-customer address, including bulk orders.  In both Portugal and Spain if your end-customer has only recently registered for VAT and their details are not yet in VIES, then you can enter their VAT ID by selecting “NIF//CIF/VAT ID not registered” and your order will proceed as normal.

Spain: Number Type offerings

Colt Number Life Cycle

The below diagram provides a view of number status [cliStatus] transition based on API action:

Ported-In Number Life Cycle

The below diagram provides a view of number status [cliStatus] transition based on API action:

Number Format

Colt REST APIs support these number formats:

• E164 international format, combination of {startFullNumber & endFullNumber} in the APIs

Example: French national number range 03.82.50.xx.x0 – x9

Split format to E164 format mapping

Number Status 

Please find the list of resourceStatus supported by Colt APIs, with associated country availability & description.

Number Action & Transition

The below table provides status transition depending on user action and country:

Order ID

After order creation, a unique ID [orderID] will be returned to you.

orderID follows the below pattern and format:

Order Status

Your order will have a status [orderStatus], that will vary over the time and the scenarios.

Non porting related orders have a 2 steps update: ‘In progress’, from order creation until completion, and then the final status.

Please find below orderStatus and description:

Please note: If a failure occurs whilst updating the Emergency Database for the order types below, a message: “Your order is technically completed and pending for emergency database update" will be shared as a new Order Description.  Order types are:-

• Activation
• Deactivation
• Address Update
• Reactivation
• Port-In
• Port-Out

Email notifications will be triggered for Port-In and Port-Out orders with the same message. Post the successful completion of an order which reflects the successful update of the Emergency Database, the order description will be updated to: “Request has been processed successfully.”

Applicable for all countries except DE, DK and Zone B.

Porting related orders have multiple updates, at each key order milestone.

• For port updates, Colt API will return a new orderID, named ‘Child Order ID’.
• Please track child orderID to get status of the update (mainly for cancellation & date change) and please continue to track parent ID to get order status.

Please refer to porting sections for more information.

Port-In

Port-In in the Netherlands

NL 088 numbers

We have automated the ability for you to port-in your own / your end-customers’ own 088 Nomadic Numbers in the Netherlands using our Port-in/out APIs and our NOD portal.  088 numbers give you and your end-customers full country coverage.

Port-In/Out journey :

The porting journey for 088 numbers is similar to the existing journey for geographic numbers, with a few exceptions.  To Port-In 088 numbers:-

• It is mandatory that you provide the ACM document in addition to the mandatory LOA document.
  • The ACM document must be provided in the ‘regulatoryAssignmentFileName’ / ‘regulatoryAssignmentFileContent’ fields
• LAC validation will not be applicable for orders with 088 numbers
• Address validation will be done
• ‘country’ field will only accept ‘NL’ as the value
• A combination of 088 numbers and other numbers with a different LAC in the same order will be rejected
• There is no change to the address fields or Directory Services update

Please note:

• The Porting Desk may receive a direct notice from the Regulator in the Netherlands (ACM/COIN) that 088 numbers under your account have been revoked. Colt NL porting desk will notify you of this revoke notification and inform you on the next steps to undertake and timelines.
• In case of no response or adequate actions, Colt NL Porting Desk will deactivate the affected numbers in the local registry and on the Colt network as per regulatory obligations.

Activation journey:

Activation of 088 numbers should be placed using PortIn API.

To Activate 088 numbers:-

• It is mandatory that you provide the ACM document.
  • The ACM document must be provided in the ‘regulatoryAssignmentFileName’ / ‘regulatoryAssignmentFileContent’ fields
• LAC validation will not be applicable for orders with 088 numbers
• Address validation will be done
• ‘country’ field will only accept ‘NL’ as the value
• A combination of 088 numbers and other numbers with a different LAC in the same order will be rejected
• There is no change to the address fields or Directory Services update
• Contract details are not required in activation journey.
• Post successful activation, you’ll be notified.

The Activation request will move from In Progress status to ‘Submitted to Local DB’ and number status will be ‘Port In Reserved’ and will be sent to PTXS. PTXS will either accept or reject the request within 3 working days.

If Rejected, order will move from In Progress to Rejected. Possible ejection reasons are:

1. Blocking code 10 -  Numbers already active please raise a port request for this!
2. Blocking code 11: No valid ACM assignment exists for these numbers please contact Dutch regulatory ACM to sort this.  (11)
3. Blocking code 99: Other- please refer to the notes section

If Accepted, Colt will process the activation automatically and order will move from ‘Submitted to Local DB’ to ‘Completed’ and number status will be updated from ‘Port In Reserved’ to ‘Port In Allocated’ to ‘Port In Activated’.

Please find below list of the ones applicable to Port-In orders:

In API we have fields to upload documents. Post the submission of request Colt will create the doc with filename and content provided by you in the request

and send it to respective teams in Colt as attachment.

FileName   <user to enter the document name. Accepted file formats: .doc/.DOC, .docx/.DOCX, .pdf/.PDF>

FileContent  <user to add the file content: encode PDF/DOC file to plain text-Base64 >

ADD & MODIFY using address update APIs (NL)

Below are for the Netherlands only:-

• End Customer Details and the Directory Services entry  are Mandatory for Activation, Portin and Address update (ADD) scenarios.
  • As the Emergency address is optional, then the end customer details will be populated in the emergency database (if the emergency address is not provided)
  • If the Emergency address is provided, then no LAC validation will be done on the emergency address and it will be populated in the emergency database
  • LAC validation applies to the End Customer address only

• Emergency Address is optional in Address update (action=ADD).
  • If the Emergency address is provided, then no LAC validation will be done on the emergency address and it will be populated in the emergency database

• In an Address Update(Modify) request the customer can include any or ALL of these as conditional mandatory:
  • Directory Services entry, and/or
  • the End Customer Address and/or
  • the Emergency Address.
  • If the Emergency address is provided, then it will be populated in the emergency database.  Any new or updated Emergency address will be validated before it is accepted.  LAC validation does not apply to emergency address.
  • LAC validation applies to the End Customer address only

• ADD operation is only applicable to Premium customers and MODIFY is applicable for both Standard and Premium customers.

Phonebook Publication

In Belgium, Ireland, Italy, Portugal, Sweden, Netherlands, Spain, Austria and UK, Colt APIs allows you to provide and update Directory Service as well.

In the Netherlands, you can use the activation, Port-In and address update functionality to provide new or additional Address and Directory Services information at an order and/or at a CLI level.

Please refer to below table while submitting the request for these countries.

Below is the TMF compliant error payload:

{

  "code": "ERR01",

  "reason": "string",

  "message": "string"

}

Error Codes

Below are the error codes which comes as the part of API response

Please click here to access Wholesale SIP documents like API guides, service matrix, Numbers on Demand user guide and release notes.