Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/bics-network-pricelist-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: mynumbers-number Pricelist API
description: BICS MyNumbers API makes it easy to order ready to use Cloud Numbers (IBN), International Freephone Numbers (ITFS) and Global Mobile Numbers (GMN).
version: v1
servers:
- url: https://api.bics.com/mynumbers-number/v1
- url: https://sandbox.api.bics.com/mynumbers-number/v1
tags:
- name: pricelist
description: Query your pricelist.
paths:
/pricelist/product/{product}:
parameters: []
get:
tags:
- pricelist
summary: Query your current pricelist
description: Query your current pricelist by product in order to know the pricing applicable to our numbers in each country.
operationId: getPricelistByProduct
parameters:
- name: product
in: path
description: Retrieve your current pricelist by product.
required: true
allowEmptyValue: false
schema:
type: string
description: Retrieve your current pricelist by product.
readOnly: false
example: IBN
responses:
'200':
description: successful operation
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/fees'
example: null
example: "[\n {\n 'product': 'IBN',\n 'country': 'BEL',\n 'accessArea': 'Mobile',\n 'profile': 'profile A',\n 'locations': ['Antwerp', 'Brussels', 'Leuven', 'Liege'],\n 'locationsAreaCodes': [\n {\n 'location': 'Antwerp',\n 'areaCode': '3'\n },\n {\n 'location': 'Brussels',\n 'areaCode': '2'\n },\n {\n 'location': 'Leuven',\n 'areaCode': '16'\n },\n {\n 'location': 'Liege',\n 'areaCode': '4'\n }\n ],\n 'nonUsageFees': {\n 'setUpFee': 10.00,\n 'MonthlyFee': 5.00,\n 'currency': 'EUR'\n },\n 'usageFees': [\n {\n 'accessNetwork': null,\n 'accessType': 'fixPay',\n 'calendar': 'SINT',\n 'tde': 'STD',\n 'callSetUpFee': 0.0005,\n 'perMinuteFee': 0.0015,\n 'currency': 'EUR'\n },\n {\n 'accessNetwork': 'SMART',\n 'accessType': 'Mob',\n 'calendar': 'SINT',\n 'tde': 'STD',\n 'callSetUpFee': 0.0005,\n 'perMinuteFee': 0.0020,\n 'currency': 'EUR'\n }\n ]\n }\n]\n"
'400':
description: Bad request, An issue occurred while processing the input parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/error'
example: null
'401':
description: the API Key was not mentioned or is invalid (see authentication)
content:
application/json:
schema:
$ref: '#/components/schemas/error'
example: null
'403':
description: this service cannot be used according to your API Key
content:
application/json:
schema:
$ref: '#/components/schemas/error'
example: null
x-operation-id-source: normalized
x-operation-id-original: get Pricelist By Product
/pricelist/product/{product}/country/{country}:
parameters: []
get:
tags:
- pricelist
summary: Query your current pricelist for a specific country
description: Query your current pricelist by product and country in order to know the pricing applicable to our numbers in a given country.
operationId: getPricelistByProductAndCountry
parameters:
- name: product
in: path
description: Retrieve your current pricelist by product.
required: true
allowEmptyValue: false
schema:
type: string
description: Retrieve your current pricelist by product.
readOnly: false
example: IBN
- name: country
in: path
description: Filter pricelist by country in ISO 3166-1 alpha-3 format.
required: true
allowEmptyValue: false
schema:
type: string
description: Filter pricelist by country in ISO 3166-1 alpha-3 format.
readOnly: false
example: BEL
responses:
'200':
description: successful operation
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/fees'
example: null
example: "[\n {\n 'product': 'IBN',\n 'country': 'BEL',\n 'accessArea': 'Mobile',\n 'profile': 'profile A',\n 'locations': ['Antwerp', 'Brussels', 'Leuven', 'Liege'],\n 'locationsAreaCodes': [\n {\n 'location': 'Antwerp',\n 'areaCode': '3'\n },\n {\n 'location': 'Brussels',\n 'areaCode': '2'\n },\n {\n 'location': 'Leuven',\n 'areaCode': '16'\n },\n {\n 'location': 'Liege',\n 'areaCode': '4'\n }\n ],\n 'nonUsageFees': {\n 'setUpFee': 10.00,\n 'MonthlyFee': 5.00,\n 'currency': 'EUR'\n },\n 'usageFees': [\n {\n 'accessNetwork': null,\n 'accessType': 'fixPay',\n 'calendar': 'SINT',\n 'tde': 'STD',\n 'callSetUpFee': 0.0010,\n 'perMinuteFee': 0.0015,\n 'currency': 'EUR'\n },\n {\n 'accessNetwork': 'SMART',\n 'accessType': 'Mob',\n 'calendar': 'SINT',\n 'tde': 'STD',\n 'callSetUpFee': 0.0020,\n 'perMinuteFee': 0.0020,\n 'currency': 'EUR'\n }\n ]\n }\n]\n"
'400':
description: Bad request, An issue occurred while processing the input parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/error'
example: null
'401':
description: the API Key was not mentioned or is invalid (see authentication)
content:
application/json:
schema:
$ref: '#/components/schemas/error'
example: null
'403':
description: this service cannot be used according to your API Key
content:
application/json:
schema:
$ref: '#/components/schemas/error'
example: null
x-operation-id-source: normalized
x-operation-id-original: get Pricelist By Product And Country
components:
schemas:
fees:
required:
- accessArea
- country
- product
- profile
type: object
properties:
usageFees:
type: array
items:
$ref: '#/components/schemas/usageFees'
example: null
country:
type: string
description: Country code in ISO 3166-1 alpha-3 format.
example: BEL
locationsAreaCodes:
type: array
items:
$ref: '#/components/schemas/locationAreaCode'
example: null
product:
type: string
description: Valid product codes are 'IBN' and 'ITFS'. IBN referring to Cloud Numbers and ITFS referring to International Freephone.
example: IBN
accessArea:
type: string
description: Tariff and/or service differentiator within a country. It intervenes in the billing.
example: Mobile
profile:
type: string
description: Tariff differentiator within a country. It intervenes in the billing.
example: profile A
locations:
type: array
items:
type: string
description: List of locations. A Location indicates in most cases the city the number belongs to. It is sometimes used to specify if it is a national or a mobile number.
example: Brussels
example: null
nonUsageFees:
$ref: '#/components/schemas/nonUsageFees'
example: null
error:
type: object
properties:
code:
type: string
description: Error code, the complete description can be found in API documentation
example: EXXX
description:
type: string
description: Description of the error, the complete description can be found in API documentation
example: Description of the error that occurred.
timestamp:
type: string
description: timestamp of error in UTC format
format: date-time
example: null
example: null
usageFees:
type: object
properties:
accessType:
$ref: '#/components/schemas/accessType'
calendar:
type: string
description: Pricing Calendar Code.
example: SINT
tde:
type: string
description: Time division element that differentiates the price based on the day and time of the call. <ul> <li>`STD` - Standard</li> <li>`P` - Peak</li> <li>`OP` - Off Peak</li> <li>`OOP` - Off Off Peak</li> <li>`WED` - Weekend</li> </ul>
example: OP
enum:
- STD
- P
- OP
- OOP
- WED
callSetUpFee:
type: string
example: '0.001'
accessNetwork:
type: string
description: Parameter describing the network of the calling party. Different routes can be used per access network. If not specified the same routing will be applied to all access Networks.
example: SMART
currency:
$ref: '#/components/schemas/currency'
perMinuteFee:
type: string
example: '0.0015'
description: Usage fees define the call setup and per minute fees.
example: null
currency:
type: string
enum:
- EUR
- USD
- ZAR
example: null
nonUsageFees:
type: object
properties:
MonthlyFee:
type: string
description: Monthly recurring fee.
example: '0.2'
setUpFee:
type: string
description: Setup Fee
example: '0.4'
currency:
$ref: '#/components/schemas/currency'
description: Non usage fees define the setup and monthly recurring fees.
example: null
locationAreaCode:
type: object
properties:
areaCode:
type: string
description: Area code of the number according to the national numbering plan.
example: '2'
location:
type: string
description: A Location indicates in most cases the city the number belongs to. It is sometimes used to specify if it is a national or a mobile number.
example: Antwerp
example: null
accessType:
type: string
description: "Access type of the calling party. You can apply a different routing per access type. The possible values are\n<ul>\n <li> fix: Fix line</li>\n <li> mob: Mobile line</li>\n <li> pay: Payphone line</li>\n <li> fixMob: Fix and Mobile lines</li>\n <li> fixPay: Fix and Payphone lines</li>\n <li> mobPay: Mobile and Payphone lines</li>\n <li> fixMobPay: Fix, Mobile and Payphone lines</li>\n</ul>\n"
enum:
- fix
- mob
- pay
- fixMob
- fixPay
- mobPay
- fixMobPay
example: null