---
title: "A group: members' first names, weekly slot, whether it asks to join, upcoming matches"
method: GET
path: "/api/v1/groups/{code}"
tags: ["groups"]
---

# A group: members' first names, weekly slot, whether it asks to join, upcoming matches

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

## Request

- Base URL: `https://kicksma.sh`
- URL: `https://kicksma.sh/api/v1/groups/{code}`
- Auth: none declared

## Path parameters

- `code` string, required

## Response `200`

The group

- Group
  - `code` string
  - `name` string
  - `url` string
  - `calendarUrl` string
  - `venue` object
  - `tz` string
  - `type` string
  - `capacity` integer
  - `level` object, nullable
    - `min` number, nullable
    - `max` number, nullable
    - `preset` string, nullable: bronze, silver, gold, platinum or custom
    - `verifiedOnly` boolean: Only levels confirmed by an organizer, a coach or the club walk in; declared levels inside the range ask to join.
  - `weekly` object, nullable
    - `weekday` integer: 0 = Sunday
    - `time` string
    - `leadDays` integer
  - `askToJoin` boolean: New people ask to join and an admin approves, on the group page. Off: anyone with the link joins.
  - `memberCount` integer
  - `members` object[]: First names. A member's level is for the group's own members, so it is always null here.
    - `name` string
    - `level` number, nullable: Always null in public output.
    - `admin` boolean
  - `upcoming` object[]
    - `code` string
    - `url` string
    - `startsAt` string
    - `title` string, nullable
    - `category` 'men' | 'women' | 'mixed' | 'null', nullable: Who the match is for; null for anyone. Information only: nobody is checked when they join.
    - `ageMin` 35 | 45 | 55 | null, nullable: An age tag, read as 35+, 45+ or 55+; null for any age. Information only.

## Other responses

- `404`: No such group

---

[API](https://skmtc.dev/kicksma/apis/kicksmash-api.md) · [All operations](https://skmtc.dev/kicksma/apis/kicksmash-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kicksma/apis/kicksmash-api/revisions/8ae952aa0f19?raw)