FAQ

General

Why do I keep getting a 401 Unauthorized error?


a. Your apiKey is not correct. Make sure the apiKey you are using is the same as the one BICS has provided you and does not contain spaces.

b. You are not allowed to use the service with the apiKey you provided. Please retry with an apiKey that has the rights to access the service or contact us to request an apiKey for this service. contacting the support team.

Why do I keep getting a 403 Forbidden error?


a. The maximal number of requests you can do in one hour with your apiKey is reached. You will need to wait some time (max one hour) before you can do requests again. If you want to increase your request limit, please contact us.

b. Your apiKey is not correct. Make sure the apiKey you are using is the same as the one BICS has provided you and does not contain spaces.

Why do I keep getting a 429 Too Many Requests error?


The maximal number of requests you can do in one hour with your apiKey is reached. You will need to wait some time (max one hour) before you can do requests again. If you want to increase your request limit, please contact us.

How many requests can I do?


We support 100 APIs/Sec for an account. If you have a larger requirement our account management team will be happy to support you and make it possible.

mCheck

Which numbering formats can I use?


It is possible to provide the phone number in different, often used, setups like:

  • 12345678900
  • +12345678900
  • +12 345 67 89 00
  • +12.345.67.89.00
  • +12 (345) 67 89 00
  • (+12) 345 67 89 00
  • Etc.
Attention: Do not insert a “/” in your phone number. It will result in not getting mCheck info for the phone number.

Does mCheck support number portability?


Yes. We support portability for several countries, such as: Australia, Austria, Belgium, Brazil, Czech Republic, Finland, France, Germany, Ghana, Italy, Mexico, Netherlands, New Zealand, Poland, South Africa, Spain, Sweden, Switzerland and the United Kingdom.

How can I implement mCheck in my own application?


Very easy, take a look at our code snippet on the mCheck page.

Are multiple requests for the same number allowed?


Yes. We do not block repeated requests for the same number. Please note that you will be billed for each individual request.

Does the mCheck info for a phone number change over time?


Yes. Our databases are constantly improved.

How long will it take for me to get a mCheck response?


The API has a maximum response time of 15 seconds. The average response time should be less than a second, so if you consistently see higher latencies, please raise a ticket.

What to do when a phone number is shown as fraudulent, and I know it isn’t?


BICS maintains a history of all phone numbers associated with frauds like Toll Free Fraud, Revenue Share frauds, Artificial Inflation of traffic, SMS Spamming, Premium number abuse, etc. Traffic going towards these numbers is considered highly risky. BICS has a rich dataset of fraud numbers developed based on its unique crowdsourcing platform across its global traffic. In case of discrepancies please raise a ticket.

Is the phone number length validated for all number types?


The phone number length is only validated for all fixed or mobile phone numbers from around the world.

What is the ISO country code?


ISO 3166-1 alpha-3 codes are three-letter country codes defined in ISO 3166-1, part of the ISO 3166 standard published by the International Organization for Standardization (ISO), to represent countries, dependent territories, and special areas of geographical interest. See the full list on the ISO’s website.

What does it mean when a phone number is marked as fraudulent in mCheck?


BICS maintains a history of all phone numbers associated with frauds like Toll Free Fraud, Revenue Share frauds, Artificial Inflation of traffic, SMS Spamming, Premium number abuse, etc. Traffic going towards these numbers is considered highly risky. BICS has a rich dataset of fraud numbers developed based on its unique crowdsourcing platform across its global traffic.

What are MCC and MNC codes?


Mobile Country Codes (MCC) are used in wireless telephone networks in order to identify the country which a mobile subscriber belongs to. In order to uniquely identify a mobile subscribers network the MCC is combined with a Mobile Network Code (MNC). mCheck returns the MCC MNC code for mobile operators.

Which operator codes are returned?


For mobile phone numbers the MCC MNC codes of the operators are returned (more info in the MCC MNC question). For all other phone number types, an arbitrary operator code is returned in by the mCheck api. Download an overview of all codes here.

Can I combine a call with mCheck and SMS API?


At this moment, the phone number is not mChecked before sending a sms to it. But you could send 2 API calls to achieve the use case. Feel Free to reach out to us if you want to combine the use case.

Why do I get inaccurate mCheck info on some American phone numbers?


Some number in the US are leased to other service providers. At this moment, mCheck will return the original carrier and not the service provider. We're working to resolve this.

What does it mean when a phone number is stated as technical?


Technical numbers are phone numbers or ranges associated with technical addresses like Global titles or MSRNs (Mobile Subscriber Roaming Ranges). Basically these numbers or ranges cannot be used by end users and you should not see any authentication or communications request coming towards these numbers.

How should I parse the mCheck results?


The mCheck results are provided in json formatting, so they are really easy to parse. Take a look at the code snippet on the mCheck page for an example.

SMS

When will a sms be sent when using openSMS?


The sms will be sent immediately after doing the openSms call

Can I know if the sms is sent correctly?


Yes. You can do a get call to the openSMS service to check the status for every request that is done.

Pricing

Which pricing system is BICS api using?


BICS api utilizes a pay per call pricing policy. The price for consulting our API’s is dependable on the total volume of API calls. Please contact us for details on pricing.

Does BICS provide a free trial period?


Yes we provide trials for limited period and limited usage. Please get in touch with our AM team from here.

Am I billed for each API call I do?


Yes, at least if your call was successfully, this means: answered with a 2XX status code.

Need more info ?


Click here to leave your information and phone number.
We’ll come back to you asap !