---
title: "Get Board Access"
method: GET
path: "/v1/pinterest/boards/{board_id}/access"
tags: ["Pinterest"]
---

# Get Board Access

`GET /v1/pinterest/boards/{board_id}/access`

## Request

- Base URL: `https://api.pinbridge.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pinbridge.io/v1/pinterest/boards/{board_id}/access`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Check whether an account can publish to a board right now.

Runs the same preflight `POST /v1/pins` uses and reports the outcome
instead of failing: `publishable` plus a stable `code` (`board_not_found`,
`board_not_owned`, `board_deleted`, `scope_missing`, `token_expired`,
`board_access_denied`, `sandbox_board_not_allowed`, ...) and a remediation
hint. `status: skipped` means Pinterest was unavailable and only local
checks ran.

## Path parameters

- `board_id` string, required

## Query parameters

- `account_id` string, uuid, required: Pinterest account ID
- `fresh` boolean: Bypass the cached verdict and ask Pinterest again

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Response `200`

Successful Response

- BoardAccessResponse: Result of ``GET /v1/pinterest/boards/{board_id}/access``.
  - `account_id` string, uuid, required
  - `board_id` string, required
  - `publishable` boolean, required
  - `status` string, required: ok, failed, or skipped (upstream unavailable)
  - `code` string, nullable: Stable reason code when not publishable
  - `message` string, required
  - `remediation` string, nullable
  - `checked_at` string, date-time, required
  - `source` string, required: simulated, local, cache, pinterest, or skipped
  - `board` object, nullable
  - `account_health` object, nullable
  - `retry_after_seconds` integer, nullable

## Other responses

- `422`: Validation Error

---

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