BSG utilizes HTTP cookies (and similar or complementary technologies) to 1) make this website safe, functional, and accessible (through the use of mandatory cookies) and 2) understand how you use our website (through the use of optional cookies) in order to improve your experience and to provide you with personalized content.

The information in the cookie text files may be related to your personal preferences or your device and is intended to make the site operate according to your expectations. The information contained in cookies does not usually identify your identity directly but is helpful in providing you with a more personalized user experience.

In accordance with the requirements of the General Data Protection Regulation (GDPR) privacy and security law that governs how the personal data of individuals in the EU may be processed and transferred, we provide you the possibility to prohibit the use of certain types of cookies when you use our website.

Read our Cookie Notice and the Privacy Policy for detailed information on how BGS collects and uses cookies. Please note that prohibiting the use of certain types of cookies may affect your interaction with the website and limit the accessibility of services we offer you. Choose the appropriate category below to learn more and to disable cookies.

Accept All cookies*
*Recommended for comfortable use of the site
Accept only necessary cookies
Accept only selected cookies
Necessary cookies
Social media
Analytics
Marketing

BSG migrated to the new DevPortal
to ship the latest One API versions faster

Use it for up-to-date endpoints, guides, and changelogs

Go to the new DevPortal
Developer Docs
Number Intelligence

Add a contact to the Stoplist

Performs adding one or more contacts to the SMS or Viber stop list. When sending SMS or Viber, messages will not be sent to numbers added to the stop list.

To add contact to the stoplist, make a request to this URL:

POST http://one-api.bsg.world/api/stoplist/attach

Request parameters:

Parameter Required Type Description
phones Yes array Array of the phone numbers
types Yes array Specify the stop list type: sms, viber

Request sample:


{
  "phones": [
    85226010227,
    85236016161
  ],
  "types": [
    "sms"
  ]
}

Response parameters

If the query is successful, you will get a 201 Successful attached.


{
    "data": [
        {
            "id": 18815384,
            "phone": 380662939860,
            "created_at": "2023-02-06 12:30:26",
            "sms_stoplist": true,
            "viber_stoplist": true
        }
    ]
}

If the query fails, an error object will be returned.

Interested in a special offer?

Ready to reach further?
Let’s talk

I agree to BSG privacy policy
Submit

Useful Materials

Apple RCS on iPhone: What Changes for Business Messaging in EU and UK

Apple RCS is live on iPhone. Which EU and UK carriers support it and how to plan campaigns with SMS fallback.

Sender ID Registration in the EU and UK: Why Your SMS Gets Filtered

Why unregistered senders get filtered in the EU and UK, and what each country requires for sender ID registration.

RCS in Brazil: Carriers, Coverage and What Works for Brands in 2026

Vivo, Claro and TIM coverage, iPhone status, where RCS beats SMS in Brazil and how to launch with SMS fallback.