List all groups

Returns a list of all groups in your account.

Endpoint

HTTP method: GET

https://api.sender.net/v2/groups

---

Request Examples

JavaScript

const url = new URL("https://api.sender.net/v2/groups");

let headers = {
    "Authorization": "Bearer [your-token]",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

PHP

$client = new \GuzzleHttp\Client();
$response = $client->get(
    'https://api.sender.net/v2/groups',
    [
        'headers' => [
            'Authorization' => 'Bearer [your-token]',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);

$body = $response->getBody()->getContents();
$data = json_decode($body, true);
print_r($data);

Python

import requests
import json

url = "https://api.sender.net/v2/groups"

headers = {
    "Authorization": "Bearer [your-token]",
    "Content-Type": "application/json",
    "Accept": "application/json",
}

response = requests.request('GET', url, headers=headers)

print(response.json())

Bash

curl -X GET \
-G "https://api.sender.net/v2/groups" \
-H "Authorization: Bearer [your-token]" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

---

Response

Example Response

{
  "data": [
    {
      "id": "b2vAR1",
      "title": "My Renamed Group",
      "recipient_count": 4,
      "active_subscribers": 2,
      "unsubscribed_count": 1,
      "bounced_count": 1,
      "phone_count": 1,
      "active_phone_count": 1,
      "account_id": "eEqqve",
      "user_id": "egp79a",
      "created": "2021-05-11 08:38:19",
      "modified": "2023-09-07 04:47:43",
      "is_recalculating_subscribers": false
    },
    {
      "id": "elxJK6",
      "title": "My Test Group",
      "recipient_count": 6,
      "active_subscribers": 4,
      "unsubscribed_count": 1,
      "bounced_count": 1,
      "phone_count": 1,
      "active_phone_count": 1,
      "account_id": "eEqqve",
      "user_id": "egp79a",
      "created": "2022-06-02 09:56:05",
      "modified": "2023-09-07 04:43:57",
      "is_recalculating_subscribers": false
    }
  ],
  "links": {
    "first": "https://api.sender.net/v2/groups?page=1",
    "last": "https://api.sender.net/v2/groups?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": null,
        "label": "pagination.previous",
        "active": false
      },
      {
        "url": "https://api.sender.net/v2/groups?page=1",
        "label": 1,
        "active": true
      },
      {
        "url": null,
        "label": "pagination.next",
        "active": false
      }
    ],
    "path": "https://api.sender.net/v2/groups",
    "per_page": 10,
    "to": 2,
    "total": 2
  }
}