---
title: "The custom boards the person is on"
method: GET
path: "/api/v1/boards"
tags: ["Save and read"]
---

# The custom boards the person is on

`GET /api/v1/boards`

## Request

- Base URL: `https://savehq.app`
- URL: `https://savehq.app/api/v1/boards`
- Auth: HTTP bearer

Custom boards: boards with a name, a public description and (for the person who made each) private instructions for what gets suggested, shared by a link; people who join add their own saves. Each with id, name, made_by_user, who else is on it (with) and join_url, the link to send. Make and change them with POST /api/v1/actions/create_board, add_to_board, take_off_board and the rest.

## Response `200`

boards (id, name, made_by_user, with, join_url)

## Other responses

- `401`: Missing, expired or revoked API key or token
- `429`: Over 60 requests a minute for this person; retry after 60 seconds

---

[API](https://skmtc.dev/savehq/apis/savehq-api.md) · [All operations](https://skmtc.dev/savehq/apis/savehq-api/llms.txt) · [OpenAPI document](https://skmtc.dev/savehq/apis/savehq-api/revisions/14aa80bad77d?raw)