Title

Description: VAT validation based on VIES API (check-vat-number) and make available to the customer.

  • NIF/VAT is mandatory parameter for PT and FI.

  • NIF/CIF/VAT and customer name is mandatory parameter for ES.

Please note: the Vies API doesn't not support the check of freelancers' DNI IDs as part of the VAT ID checker.  Please select the VAT ID not registered option to bypass the check.

  • field “companyNumberRegistered” in order details API

  • Vies API  will validate VAT/NIF for PT and FI.

  • Vies API will validate VAT/CIF/NIF + customer name for ES.

     

  • field “companyNumberRegistered” as an optional parameter in below APIs with accepted values as ‘true’ and ‘false’:

  • /v1/activation/order

  • /v1updateCustomer/order

  • /v1/portIn/order

End point URLs

  • Production: https://apis.colt.net/numberManagement/v1/check-vat-number

  • Sandbox: https://sandbox.apis.colt.net/numberManagement/v1/check-vat-number

Method: POST

Input parameters

Parameter

Type

Country

Description

header

x-tracking-id

Mandatory

PT, ES, FI

description: Unique identifier for the order

example: abcd456e-d45645-dfaafda-1232345667dd
pattern: ^[a-zA-Z0-9_.~:@-]{1,255}$
maxLength: 255

Request body

country

Mandatory

PT, ES, FI

Allowed countries: PT, ES, FI

companyRegistrationNumber

Mandatory

PT, ES, FI

string

endCustomerName

Optional/ Mandatory

PT, ES, FI

String

Mandatory for ES only

 

Sample request and response

Spain

Request

Response

{

  "countryCode": "ES",

  "companyRegistrationNumber": "A81626905",

  "endCutomerName": "Colt Technology Services SA"

}

 

{

    "countryCode": "ES",

    "vatNumber": "A81626905",

    "requestDate": "2024-04-19T06:59:34.84Z",

    "valid": true,

    "traderName": "Colt Technology Services SA",

    "traderNameMatch": "true"

}

{

  "countryCode": "ES",

  "companyRegistrationNumber": "12345",

  "endCustomerName": "Colt"

}

 

{

    "countryCode": "ES",

    "vatNumber": "12345",

    "requestDate": "2024-04-19T07:04:12.194Z",

    "valid": false,

    "traderName": "---",

    "traderNameMatch": "false"

}

 

Portugal

Request

Response

{

  "countryCode": "PT",

  "companyRegistrationNumber": "PT505289385"

}

 

{

    "countryCode": "PT",

    "vatNumber": "505289385",

    "requestDate": "2024-04-19T07:13:22.372Z",

    "valid": true,

    "traderName": "COLT TECHNOLOGY SERVICES, UNIPESSOAL LDA",

    "traderNameMatch": "false"

}

{

  "countryCode": "PT",

  "companyRegistrationNumber": "1234"

}

 

{

    "countryCode": "PT",

    "vatNumber": "1234",

    "requestDate": "2024-04-19T07:20:31.923Z",

    "valid": false,

    "traderName": "---",

    "traderNameMatch": "false"

}

 

Finland

Please note : you can also use these external links to check the end-customer has a valid VAT/business ID & signee in Finland to ensure accuracy:

Request

Response

{

  "country": "FI",

  "companyRegistrationNumber": "28429386",

  "endCustomerName": "My Customer"

}

 

{

    "country": "FI",

    "companyRegistrationNumber": "28429386",

    "requestDate": "2025-06-24T07:28:02.252Z",

    "valid": true,

    "endCustomerName": "My Customer",

    "endCustomerNameMatch": false

}

{

  "country": "FI",

  "companyRegistrationNumber": "28429386",

  "endCustomerName": "Colt"

}

 

{

    "country": "FI",

    "companyRegistrationNumber": "28429386",

    "requestDate": "2025-06-24T07:28:48.796Z",

    "valid": true,

    "endCustomerName": "My Customer",

    "endCustomerNameMatch": false

}

{

  "country": "FI",

  "companyRegistrationNumber": "1234567",

  "endCustomerName": "Colt"

}

 

{

    "country": "FI",

    "companyRegistrationNumber": "1234567",

    "requestDate": "2025-06-24T07:29:24.952Z",

    "valid": false,

    "endCustomerName": "---",

    "endCustomerNameMatch": false

}

 

Description: API to get the list of allowed operators to submit a portIn request for all countries (except DE and NL).

End point URLs

  • Production: https://apis.colt.net/numberManagement/v1/portInOperatorList

  • Sandbox: https://sandbox.apis.colt.net/numberManagement/v1/portInOperatorList

 

Method: GET

Input parameters

Parameter

Type

Description

Header

x-tracking-id

Mandatory

description: Unique identifier for the order

example: abcd456e-d45645-dfaafda-1232345667dd
pattern: ^[a-zA-Z0-9_.~:@-]{1,255}$
maxLength: 255

Query

country

Mandatory

Enum: GB, ES, FR, AT, BE, IE, IT, SE, DK, PT, CH, CZ, NO, RO, PL, FI, LU, SK

 

Sample request & response

Request

Response

Input parameters:

country: SK

 

Request URL:

https://apis.colt.net/common-services/v1/portInOperatorList?country=SK

{

    "operatorList": [

        {

            "operatorName":  "Antik computer & communications"

        },

        {

            "operatorName":  "Digital"

        },

        {

            "operatorName":  "DSiDATA"

        },

        {

            "operatorName":  "MCN Telekom"

        },

        {

            "operatorName":  "O2 Slovakia"

        },

        {

            "operatorName":  "Orange Slovakia"

        },

        {

            "operatorName":  "Other"

        },

        {

            "operatorName":  "RadioLAN"

        },

        {

            "operatorName":  "Slovak Telekom (T-COM)"

        },

        {

            "operatorName":  "Slovanet"

        },

        {

            "operatorName":  "SWAN"

        },

        {

            "operatorName":  "Trnavatel"

        },

        {

            "operatorName":  "Uniphone"

        },

        {

            "operatorName":  "UPC Broadband Slovakia"

        },

        {

            "operatorName":  "VM Telecom"

        },

        {

            "operatorName":  "VNET"

        },

        {

            "operatorName":  "Zeleznicne Telekomunikacie"

        }

    ]

}

Description: API to get the holiday calendar (list of public holidays) for specific country and year.

End point URLs

  • Production: https://apis.colt.net/numberManagement/v1/check-vat-number

  • Sandbox: https://sandbox.apis.colt.net/numberManagement/v1/check-vat-number

Method: GET

Input parameters

Parameter

Type

Description

Header

x-tracking-id

Mandatory

description: Unique identifier for the order

example: abcd456e-d45645-dfaafda-1232345667dd
pattern: ^[a-zA-Z0-9_.~:@-]{1,255}$
maxLength: 255

Query

country

Mandatory

Enum: GB, ES, FR, AT, BE, IE, IT, SE, DK, PT, CH, CZ, NO, RO, PL, FI, LU, SK

year

Mandatory

Current or next year

Example: 2026

 

Sample request & response

 

Request

Response

Input parameters:

country: SK

 

Request URL:

https://apis.colt.net/common-services/v1/portInOperatorList?country=SK

{

    "holidayCalendar": [

        {

            "holidayName": "New Year's Day",

            "holidayDate": "2026-01-01"

        },

        {

            "holidayName": "Epiphany day",

            "holidayDate": "2026-01-06"

        },

        {

            "holidayName": "Good Friday",

            "holidayDate": "2026-04-03"

        },

        {

            "holidayName": "Easter Monday",

            "holidayDate": "2026-04-06"

        },

        {

            "holidayName": "Labour Day",

            "holidayDate": "2026-05-01"

        },

        {

            "holidayName": "Saints Cyril and Methodius' Day",

            "holidayDate": "2026-07-05"

        },

        {

            "holidayName": "Slovak National Uprising Anniversary",

            "holidayDate": "2026-08-29"

        },

        {

            "holidayName": "All Saints Day",

            "holidayDate": "2026-11-01"

        },

        {

            "holidayName": "Christmas Eve",

            "holidayDate": "2026-12-24"

        },

        {

            "holidayName": "Christmas Day",

            "holidayDate": "2026-12-25"

        },

        {

            "holidayName": "Boxing Day/St. Stephen’s Day",

            "holidayDate": "2026-12-26"

        }

    ]

}

 

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

Read our terms and conditions

Please click here to access Wholesale SIP documents like the Service Matrix, Numbers on Demand user guide and release notes. 

Please click on 'API Documents' on the left to find the OAS specification.

To register and start using our Wholesale SIP APIs please click on 'Get Started'.

API Details:

Status

LIVE

Version

v1

Maturity status

Production

Endpoint (Production)

https://apis.colt.net/numberManagement/resourceName

Endpoint (Sandbox)

https://sandbox.apis.colt.net/numberManagement/resourceName

Resource names for ‘Wholesale SIP number management API’ operations

Sr no.

Function

API resource Name

Method

1

Validate Company Registration Number (VAT ID/CIF/NIF) in Portugal, Finland and Spain

/v1/check-vat-number

POST

2

API to get the list of allowed operators to submit a portIn request for all countries (except DE and NL).

/v1/portInOperatorList

GET

3

API to get the holiday calendar (list of public holidays) for specific country and year.

/v1/holidayCalendar

GET

commonServices_v1.1.0_30May2025 (2)_0.yaml (27.92 KB)
commonServices_v1.1.0_30May2025 (2)_1.yaml (27.92 KB)
Voice Common Services v1.docx (125.02 KB)