Developer Docs

Table of contents

Get lists

Provides an index of all the contact lists with data.

To get a contact list, make a request to this URL:

GET http://one-api.bsg.world/api/groups
Request parameters
ParameterRequiredTypeDescription 
pageNointegerPaginator page, minimum ― 1. Default ― 1.
per_pageNointegerThe number of entries in the response. Minimum ― 10, maximum ― 1000. Default ― 20.

Request example:

{
  "name": "This is my group",
  "description": "This is my group",
  "default": true
}
Response parameters:
ParameterTypeDescription 
idintegerThe unique identifier of the contact list automatically generated by the BSG system when creating the contact list.
namestringContact list name.
descriptionstringContact list description.
defaultbooleanIf the contact list is a default one. Possible values: true or false.
created_atdatetimeDate and time when the contact list was created. Display format ― Y-m-d H:i:s
totalintegerTotal number of the existing contact lists.

If request is successful, you will receive a response:

{
  "data": [
    {
      "id": 1,
      "name": "string",
      "description": "string",
      "default": 0,
      "created_at": "2022-04-28 14:21:16"
    }
  ],
  "total": 1
}

We use cookies (and other similar technologies) to collect data to improve your experience on our site. By using our website, you’re agreeing to the collection of data as described in our Website Data Collection Policy.