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
Developer Docs
Number Intelligence

Search Contact List

Method for searching the list of contacts using operations like, =, >, >=, <, <=. Search is possible by the following fields:

  • name
  • description
  • date
  • items
  • phone
  • id

To search Contact List, make a request to this server:

GET http://one-api.bsg.world/api/groups/search

Request parameters:

Parameter Required Type Default Description
page[offset] No integer 0 Get contact groups starting from offset
page[limit] No integer 50 Number of contact groups in response
sort No string id Sort by conditions: id, items, name, description, date
way No string asc Sorting options: asc, desc
search[operator] No string = Operator for finding values: like, =, >, >=, <, <=
search[field] No string no Fields for search: name, items, date, description, phone, id
search[value] Value for search: No string no
name List name. Up to 50 characters
description List description. Up to 250 characters
date Date of the list creation in the format ISO 8601: yyyy-mm-dd hh:mm:ss
items Number of contacts in the list
phone Phone number which a list contains/does not contain. 9 to 15 digits
id Contact list ID

Response parameters:

Parameter Type Description
id integer List ID
name string List name
description string List description
is_default boolean Whether the list is the default. Possible values: true, false
items integer Number of contacts in the list
created at string Date and time the list was created. Format ISO 8601 yyyy-mm-dd hh:mm:ss

If the request is successful, you will receive a response:


{
  "data": [
    {
      "id": 1,
      "name": "string",
      "description": "string",
      "is_default": true,
      "items": 0,
      "created_at": "2022-04-28 14:21:16"
    }
  ],
  "meta": {
    "page": {
      "total": 1,
      "offset": 20,
      "limit": 40
    },
    "search": {
      "field": "id",
      "operator": "like",
      "value": "string"
    }
  }
}

Interested in a special offer?

Ready to reach further?
Let’s talk

I agree to BSG privacy policy
Submit

Useful Materials

What Is Number Verifier — And Why It’s More Than Just an “HLR Lookup”

30% of SMS fail — not because of content, but numbers. Verify before you send.

10 Awesome Back-to-School Marketing Ideas 2025

The start of the school year: when parents trade in their summer margaritas for the

What Is CPaaS? Communications Platform as a Service

Talking to customers these days is more than just emails or phone calls. Businesses need