List Groups
GET /api/cc/groups
Your approved agent groups that have a number — the ones a campaign can use. The group’s agents take the campaign’s calls, and its number is the caller ID the customer sees.
Requires a Bearer API token (from Authentication / dashboard API Tokens) and the call-center permission.
Rate limit: 60 requests per minute per account, shared by all Campaign API endpoints.
Request Example
Section titled “Request Example”curl -X GET https://api.awajdigital.com/api/cc/groups \ -H "Authorization: Bearer your_api_token_here" \ -H "Accept: application/json"// Browser JavaScript (Fetch API)const response = await fetch('https://api.awajdigital.com/api/cc/groups', { method: 'GET', headers: { 'Authorization': 'Bearer your_api_token_here', 'Accept': 'application/json' }});
const data = await response.json();console.log(data);// Node.js with axiosconst axios = require('axios');
async function listGroups() { try { const response = await axios.get('https://api.awajdigital.com/api/cc/groups', { headers: { 'Authorization': 'Bearer your_api_token_here', 'Accept': 'application/json' } });
console.log(response.data); } catch (error) { console.error('Error:', error.response?.data || error.message); }}
listGroups();# Python with requestsimport requests
def list_groups(): url = 'https://api.awajdigital.com/api/cc/groups' headers = { 'Authorization': 'Bearer your_api_token_here', 'Accept': 'application/json' }
try: response = requests.get(url, headers=headers) print(response.json()) except requests.exceptions.RequestException as e: print(f'Error: {e}')
list_groups()<?php// PHP with cURL$url = 'https://api.awajdigital.com/api/cc/groups';$token = 'your_api_token_here';
$ch = curl_init($url);curl_setopt($ch, CURLOPT_HTTPGET, true);curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'Authorization: Bearer ' . $token, 'Accept: application/json']);curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);curl_close($ch);
$result = json_decode($response, true);print_r($result);?>Success Response Example
Section titled “Success Response Example”{ "data": [ { "id": 7, "name": "Sales", "calling_number": "09612345678", "agent_count": 4 } ]}| Field | Type | Description |
|---|---|---|
| id | integer | Pass as group_id to Create Campaign. |
| name | string | The group’s name. |
| calling_number | string | The caller ID the customer sees. |
| agent_count | integer | Agents in the group. |
Error Responses
Section titled “Error Responses”| Status | Code | Description |
|---|---|---|
| 401 | — | Missing or invalid access token |
| 403 | — | Account does not have the call-center permission |
| 429 | — | Rate limit exceeded (60 requests/minute) |
