---
title: "Get all groups"
method: GET
path: "/groups"
tags: ["Groups"]
---

# Get all groups

`GET /groups`

Returns a paginated list of all groups for your organization. Use this endpoint to sync group records into an external system or to find groups by name or parent. Filter by parent_id to retrieve only direct child groups of a specific group, or use the date filters to retrieve only recently created or modified groups.

## Query parameters

- `name_like` string
- `parent_id` string
- `created_before` string, date-time
- `created_after` string, date-time
- `updated_before` string, date-time
- `updated_after` string, date-time

## Response `200`

Returns the paginated list of groups for your organization. The response includes pagination links and meta fields to navigate additional pages.

- object
  - `data` GroupResource[]
    - `id` integer — The ID of the group
    - `name` string — The name of the group
    - `description` string — A description for the group
    - `has_subgroups` boolean — If the group has subgroups
    - `parent_id` integer — The group ID of the parent group
    - `subgroups` GroupResource[] — Child subgroups of this group. Present only when the 'children' relation is loaded (e.g. on detail endpoints).
    - `parent` GroupResource — recursive
    - `created_at` string, date-time — The date and time the group was created at
    - `updated_at` string, date-time — The date and time the group was last updated at
  - `links` PaginationLinks — Pagination navigation links returned on every paginated list response. Each URL points at the specific list endpoint being called.
    - `first` string — A link to the first page of results
    - `last` string — A link to the last page of results
    - `prev` string, nullable — A link to the previous page of results, or null on the first page
    - `next` string, nullable — A link to the next page of results, or null on the last page
  - `meta` PaginationMeta — Pagination metadata returned on every paginated list response.
    - `current_page` integer — The current page
    - `from` integer — The index of the first result on this page
    - `last_page` integer — The number of the last page of results
    - `to` integer — The index of the last result on this page
    - `path` string — The base URL of the list endpoint
    - `per_page` integer — The number of results per page
    - `total` integer — The total number of results

## Other responses

- `401` — Authentication credentials are missing or invalid.
- `429` — You have exceeded the rate limit of 30 requests per minute per API key.
- `500` — An unexpected server error occurred.

---

[API](https://skmtc.dev/vomo/apis/vomo-api.md) · [All operations](https://skmtc.dev/vomo/apis/vomo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vomo/vomo-api/revisions/1582d52b5f1f/schema)