## Get a board by ID

**get** `/v2/boards/{id}`

Retrieves a single board by its unique identifier.

Returns the full board object including all access controls,
feature toggles, and localization settings.

### Path Parameters

- `id: string`

  Board unique identifier

### Header Parameters

- `"Featurebase-Version": optional "2026-01-01.nova" or "2025-12-12.clover"`

  - `"2026-01-01.nova"`

  - `"2025-12-12.clover"`

### Returns

- `Board object { id, access, createdAt, 7 more }`

  - `id: string`

    Unique identifier

  - `access: object { adminOnly, allowedRoles, deniedRoles, segments }`

    - `adminOnly: boolean`

      If true, only admins can see this board

    - `allowedRoles: array of string`

      Role IDs allowed access (empty = all)

    - `deniedRoles: array of string`

      Role IDs explicitly denied access

    - `segments: array of string`

      Segment IDs that can access (empty = all)

  - `createdAt: string`

    ISO 8601 timestamp when created

  - `customFields: array of string`

    Custom field IDs attached to this board

  - `features: object { commentsEnabled, createdDatesVisible, postingEnabled }`

    - `commentsEnabled: boolean`

      Whether users can comment on posts

    - `createdDatesVisible: boolean`

      Whether creation dates are visible on posts

    - `postingEnabled: boolean`

      Whether users can create new posts

  - `icon: object { type, value }  or object { type, value }  or object { type, value }`

    The board's icon. Can be one of three types:

    - **emoji**: A single emoji character (e.g., 💡, 🚀, ⭐)
    - **icon**: A predefined icon from the built-in library (e.g., lightbulb, bug, star)
    - **url**: A custom image URL (HTTPS required)

    Can be `null` if no icon is set.

    - `EmojiIcon object { type, value }`

      An emoji character as the board icon

      - `type: "emoji"`

        Emoji icon type

        - `"emoji"`

      - `value: string`

        A single emoji character

    - `PredefinedIcon object { type, value }`

      A predefined icon from the built-in icon library

      - `type: "icon"`

        Predefined icon type

        - `"icon"`

      - `value: string`

        Icon name from the predefined icon set (e.g., lightbulb, bug, star, rocket, flag, heart, check, question, megaphone, gift)

    - `URLIcon object { type, value }`

      A custom icon loaded from an external URL

      - `type: "url"`

        External URL icon type

        - `"url"`

      - `value: string`

        HTTPS URL to a custom icon image (PNG, SVG, or WebP recommended)

  - `localization: object { description, formPlaceholder, heroDescription, 3 more }`

    - `description: map[string]`

      Localized description

    - `formPlaceholder: map[string]`

      Placeholder text in the post creation form

    - `heroDescription: map[string]`

      Hero description/subtitle

    - `heroTitle: map[string]`

      Hero title shown on the board page

    - `name: map[string]`

      Localized board name (language code → text)

    - `submitButtonText: map[string]`

      Submit button text

  - `name: string`

    Display name in organization's default locale

  - `object: "board"`

    Object type identifier

    - `"board"`

  - `postDefaults: object { visibility }`

    - `visibility: "public" or "authorOnly" or "companyOnly"`

      Default visibility for new posts

      - `"public"`

      - `"authorOnly"`

      - `"companyOnly"`

### Example

```http
curl https://do.featurebase.app/v2/boards/$ID \
    -H "Authorization: Bearer $FEATUREBASE_API_KEY"
```

#### Response

```json
{
  "id": "507f1f77bcf86cd799439011",
  "access": {
    "adminOnly": false,
    "allowedRoles": [
      "string"
    ],
    "deniedRoles": [
      "role_blocked"
    ],
    "segments": [
      "string"
    ]
  },
  "createdAt": "2023-12-12T00:00:00.000Z",
  "customFields": [
    "cf_priority",
    "cf_category"
  ],
  "features": {
    "commentsEnabled": true,
    "createdDatesVisible": true,
    "postingEnabled": true
  },
  "icon": {
    "type": "emoji",
    "value": "💡"
  },
  "localization": {
    "description": {
      "en": "Submit and vote on feature ideas"
    },
    "formPlaceholder": {
      "en": "Describe your feature idea..."
    },
    "heroDescription": {
      "foo": "string"
    },
    "heroTitle": {
      "en": "Share your ideas"
    },
    "name": {
      "en": "Feature Requests",
      "es": "Solicitudes de funciones"
    },
    "submitButtonText": {
      "en": "Submit Feedback"
    }
  },
  "name": "Feature Requests",
  "object": "board",
  "postDefaults": {
    "visibility": "public"
  }
}
```