Get Your List Name and IDs

Retrieve all contact lists created in your account along with their ListIDs

In the MainBrainer CRM, contacts can be grouped under various Lists. Each list is assigned a unique List ID that acts as a Unique identifier for the particular list. Use this endpoint to retrieve the list of all contact lists created under your MainBrainer account along with their corresponding ListIDs.

Request
Security:
Bearer
query Parameters
limit
integer or null <int32>

Specify the number of contact lists that you want the endpoint to return.
Default value: 100
Maximum value: 1000

offset
integer or null <int32>

Specify the offset point, i.e., the number of contact lists you wish to skip and the point from where you would like to begin displaying the results.
Default value: 0

Responses
200

Success

400

Bad Request

401

Unauthorized

409

Conflict

422

Client Error

500

Server Error

get/lists
Request samples
const fetch = require('node-fetch');

const query = new URLSearchParams({limit: '0', offset: '0'}).toString();

const resp = await fetch(
  `https://apicrm.mainbrainer.com/lists?${query}`,
  {
    method: 'GET',
    headers: {
      Authorization: 'YOUR_API_KEY_HERE'
    }
  }
);

const data = await resp.text();
console.log(data);
Response samples
[
  • {
    • "id": "string",
    • "name": "string",
    • "description": "string",
    • "created_at": "string",
    • "updated_at": "string"
    }
]