---
title: "Get all boards that the user participates in"
method: GET
path: "/v3/boards"
tags: ["Boards"]
---

# Get all boards that the user participates in

`GET /v3/boards`

## Query parameters

- `page` integer
- `board_relationship` 'owned' | 'invited'
- `sort_order` 'date_last_updated_descending' | 'date_last_updated_ascending' | 'name_ascending' | 'name_decending'
- `pageSize` integer

## Headers

- `Accept-Language` string — Provide a header to specify the language of result values. Supported values: cs (iStock only), de, en-GB, en-US, es, fi (iStock only), fr, hu (iStock only), id (iStock only), it, ja, ko (creative assets only), nl, pl (creative assets only), pt-BR, pt-PT, ro (iStock only), ru (creative assets only), sv, th (iStock only), tr, uk (iStock only), vi (iStock only), zh-HK (creative assets only).

## Response `200`

OK

- BoardList
  - `boards` BoardListBoard[], nullable
    - `id` string, nullable
    - `asset_count` integer
    - `date_created` string, date-time
    - `date_last_updated` string, date-time
    - `description` string, nullable
    - `hero_asset` Asset
      - `id` string, nullable
      - `asset_type` string, nullable
      - `date_added` string, date-time
      - `display_sizes` DisplaySize[], nullable
        - `name` string, nullable
        - `uri` string, nullable
      - `comments` AssetComment[], nullable
        - `created_by` Collaborator
          - `first_name` string, nullable
          - `last_name` string, nullable
        - `date_created` string, date-time
        - `id` string, nullable
        - `text` string, nullable
    - `name` string, nullable
    - `board_relationship` string, nullable
  - `board_count` integer

## Other responses

- `400` — InvalidParameterValue
- `401` — Unauthorized

---

[API](https://skmtc.net/gettyimages/apis/getty-images-api.md) · [All operations](https://skmtc.net/gettyimages/apis/getty-images-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gettyimages/getty-images-api/versions/29f239eeae86/schema)