List groups

Returns a paginated list of the contact groups on your account.

GET

https://app.touchsms.com.au/api/v2/groups

Authorization

basicAuth
HTTP
required

Query parameters

search
optional
string
Search term.
sort_by
optional
name
or
created
Field to sort by.

default: "name"
sort_order
optional
asc
or
desc
Sort direction.

default: "asc"
per_page
optional
integer
Results per page.

maximum: 200 · minimum: 10 · default: 50
page
optional
integer
Page number. Prefer following links.next until it is null.

minimum: 1 · default: 1

Returns

200

A page of groups.

JSON

data
optional
array of
object
- id
  optional
  integer
- name
  optional
  string
- status
  optional
  boolean
  Whether the group is active.
- group_email
  optional
  string | null
  Email-to-SMS address that sends to every contact in the group.
  
  format: email
- is_global
  optional
  boolean
  Whether the group is shared across the whole account.
- updated
  optional
  string
  format: date-time
- created
  optional
  string
  format: date-time
}
links
optional
object
Links to other pages. next is null on the last page.
- first
  optional
  string | null
  format: uri
- last
  optional
  string | null
  format: uri
- prev
  optional
  string | null
  format: uri
- next
  optional
  string | null
  format: uri
}
meta
optional
object
Position in the result set. Read per_page rather than assuming a page size.
- current_page
  optional
  integer
- from
  optional
  integer | null
- last_page
  optional
  integer
- path
  optional
  string
  format: uri
- per_page
  optional
  integer
- to
  optional
  integer | null
- total
  optional
  integer
- links
  optional
  array of
  object
  Page links for building pagination controls.
  
  url
  optional
  string | null
  label
  optional
  string
  active
  optional
  boolean
}

401

Missing, malformed or invalid API credentials.

JSON

message
string
required

422

The request failed validation. errors lists the messages for each invalid field.

JSON

message
optional
string
errors
optional
map of
array<string>

{ "data": [ { "id": 512, "name": "Customers", "status": true, "group_email": "group-512@example.com", "is_global": false, "updated": "2024-03-11T02:14:07Z", "created": "2024-02-02T23:51:19Z" } ], "links": { "first": "https://app.touchsms.com.au/api/v2/contacts?page=1", "last": "https://app.touchsms.com.au/api/v2/contacts?page=8", "prev": null, "next": "https://app.touchsms.com.au/api/v2/contacts?page=2" }, "meta": { "current_page": 1, "from": 1, "last_page": 8, "path": "https://app.touchsms.com.au/api/v2/contacts", "per_page": 50, "to": 50, "total": 400 } }