---
title: "Get Group"
method: GET
path: "/api/v1/groups/{group_id}"
tags: ["Groups"]
---

# Get Group

`GET /api/v1/groups/{group_id}`

Returns a single group by ID, including associated websites. Requires a global API key. **Partner integrations** additionally receive an `externalId` field populated from the partner mapping (if any).

## Response `200`

Successful response with the group. Partner responses include an `externalId` field (string or `null`); direct-customer responses omit the field entirely.

- object
  - `group` Group, required — A group of websites in your organization
    - `id` string, uuid, required — Unique identifier for the group
    - `name` string, required — Display name of the group
    - `orgId` string, uuid, required — The organization ID the group belongs to
    - `billingEnabled` boolean, required — Whether billing is enabled for this group
    - `createdAt` string, date-time, required — Timestamp when the group was created (UTC)
    - `websites` GroupWebsite[], required — Websites associated with this group
      - `id` string, uuid, required — Unique identifier for the website
      - `websiteUrl` string, required — The URL of the website
      - `websiteName` string, required — Display name of the website
    - `externalId` string, nullable — **Partner-only.** The partner-supplied identifier mapped to this group. Only present on responses to callers whose organization is flagged as a partner. Direct-customer responses omit the field entirely. `null` indicates no mapping exists for this group.

## Other responses

- `400` — Bad request - Invalid group ID format
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Global API key required
- `404` — Not found - Group does not exist or does not belong to your organization
- `500` — Internal server error

---

[API](https://skmtc.net/athenahq/apis/athenahq-api.md) · [All operations](https://skmtc.net/athenahq/apis/athenahq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/athenahq/athenahq-api/versions/6c5d71622cb9/schema)