v1

latestOpenAPI 3.1.02026-07-22191956.7 KB

Groups

List groups

All groups created by your keys in the current mode, newest first.

get/groups

Query parameters

limitinteger

Page size. Default 50, max 200.

cursorstring

Opaque cursor from a previous page's nextCursor. Lists are newest-first.

Response

A page of groups.

nextCursorstring nullable

Pass as ?cursor= for the next page. null on the last page.

Example response

{
  "groups": [
    {
      "id": "grp_8c2f41d09a3e",
      "companyName": "Acme Inc",
      "domain": "acme.com",
      "externalId": "co_4821",
      "address": {
        "line1": "548 Market St",
        "city": "San Francisco",
        "state": "CA",
        "zip": "94104"
      },
      "contact": {
        "name": "Dana Park",
        "email": "dana@acme.com",
        "title": "Head of People"
      },
      "currentCoverage": {
        "planType": "fully_insured",
        "carrier": "Anthem",
        "pepmCents": 80000,
        "renewalDate": "2026-09-01"
      },
      "censusMemberCount": 12
    }
  ]
}