---
title: "Search groups"
method: GET
path: "/groups"
tags: ["groups"]
---

# Search groups

`GET /groups`

## Query parameters

- `name` string
- `latitude` number
- `longitude` number
- `distance` number
- `country` string
- `region` string
- `postal_code` string
- `page` integer
- `per_page` integer

## Response `200`

The groups and paging data.

- object
  - `groups` Group[]
    - `group_id` string
    - `name` string — The name of the group (not guaranteed to be unique).
    - `identifier` string — A unique identifier for the group that is used in URLs.
    - `homepage` string — A URL to the group homepage.
    - `member_count` integer — The number of members who belong to the group.
    - `latitude` number
    - `longitude` number
    - `timezone` string — The timezone that the group is in (eg. America/New_York).
    - `open_membership` boolean — When true, the group allows anyone to join. When false, the group moderators review and approve applicants.
    - `open_archives` boolean — When true, the group posts are viewable by anyone. When false, the group posts can only be viewed by members of the group.
    - `has_questions` boolean — When true, anyone requesting membership to this group will be required to answer a new membership questionnaire.
    - `country` object — Provides information about the country that is associated with a group. May be null.
      - `name` string — The name of the country.
      - `abbreviation` string — A 2 letter country code for the country (see https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 ).
    - `region` object — Provides information about an area within a country that a group is associated with (eg. a state in the US or a province in Canada). May be null.
      - `name` string — The name of the region.
      - `abbreviation` string — A 2 letter abbreviation for the region (is not guaranteed to be globally unique but is unique among all the regions in the country).
    - `membership` object — Provides information about the current users' active or pending membership to this group (if any). Will be null if there is no active or pending membership to this group.
      - `status` string — One of: subscribed, pending, pending-questions
      - `date` string, date-time — The UTC date and time when the membership was last updated.
      - `questionnaire` object — Membership questionnaire data. Will be null unless the membership status is pending-questions.
        - `message` string — A message from the group moderators to be displayed above the questions (may be null).
        - `questions` string[] — The list of questions.
  - `num_groups` integer — The total number of groups available.
  - `page` integer — The page number of the groups being returned.
  - `per_page` integer — The number of groups being returned per page.
  - `num_pages` integer — The total number of pages available.
  - `start_index` integer — The index of the first group being returned (an integer between 1 and num_groups).
  - `end_index` integer — The index of the last group being returned (an integer between start_index and num_groups).

## Other responses

- `400` — Missing or invalid parameters.

---

[API](https://skmtc.net/trashnothing/apis/trash-nothing.md) · [All operations](https://skmtc.net/trashnothing/apis/trash-nothing/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trashnothing/trash-nothing/versions/2db980cc9ffd/schema)