REST API: data sources

List data source groups

Read all data source groups.

Purpose

Use this call to list the groups of data sources that exist in your account.

Request

POST <API_BASE_URL>/source/groups. All calls are POST under your API address. Replace <API_BASE_URL> with the API address provided with your access.

This operation takes no permanent API token. Send a user token in the token header. See authentication and user authorization.

The body has no fields.

Response

HTTP 200. Every group of the account, sent as a bare array. This operation does not wrap its success in the status envelope.

FieldTypeDescription
group_idstring (uuid)The identifier of the group, as you send it in group_id.
createdstring (date-time)When the group was created.
namestringThe name of the group.

Errors

  • 400: The request body failed validation.
  • 401: The token is missing, expired or unknown.

A refusal can also come before the operation runs: an address outside your IP allowlist, a token bound to another address, or a body that is not valid JSON. See response format and errors.

Example

Request:

curl -X POST "<API_BASE_URL>/source/groups" \
  -H "token: <your user token>" \
  -H "Content-Type: application/json"

Response:

[
  {
    "group_id": "<group id>",
    "created": "2026-01-01T10:00:00.000Z",
    "name": "Main entrance"
  }
]

Questions about the face API?

Write to us and we will help.

Talk to us