# Get a board by ID

Retrieves a single board by its unique identifier.

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

Endpoint: GET /v2/boards/{id}
Version: 2026-01-01.nova
Security: bearerAuth

## Header parameters:

  - `Featurebase-Version` (string)
    API version for this request. Defaults to your organization's configured API version if not specified.
    Example: "2026-01-01.nova"

## Path parameters:

  - `id` (string, required)
    Board unique identifier
    Example: "507f1f77bcf86cd799439011"

## Response 200 fields (application/json):

  - `object` (string, required)
    Object type identifier
    Enum: "board"

  - `id` (string, required)
    Unique identifier
    Example: "507f1f77bcf86cd799439011"

  - `name` (string, required)
    Display name in organization's default locale
    Example: "Feature Requests"

  - `icon` (any, required)
    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.

  - `access` (object, required)

  - `access.adminOnly` (boolean, required)
    If true, only admins can see this board

  - `access.segments` (array, required)
    Segment IDs that can access (empty = all)
    Example: []

  - `access.allowedRoles` (array, required)
    Role IDs allowed access (empty = all)
    Example: []

  - `access.deniedRoles` (array, required)
    Role IDs explicitly denied access
    Example: ["role_blocked"]

  - `features` (object, required)

  - `features.postingEnabled` (boolean, required)
    Whether users can create new posts
    Example: true

  - `features.commentsEnabled` (boolean, required)
    Whether users can comment on posts
    Example: true

  - `features.createdDatesVisible` (boolean, required)
    Whether creation dates are visible on posts
    Example: true

  - `postDefaults` (object, required)

  - `postDefaults.visibility` (string, required)
    Default visibility for new posts
    Enum: "public", "authorOnly", "companyOnly"

  - `customFields` (array, required)
    Custom field IDs attached to this board
    Example: ["cf_priority","cf_category"]

  - `localization` (object, required)

  - `localization.name` (object, required)
    Localized board name (language code → text)
    Example: {"en":"Feature Requests","es":"Solicitudes de funciones"}

  - `localization.description` (object,null, required)
    Localized description
    Example: {"en":"Submit and vote on feature ideas"}

  - `localization.formPlaceholder` (object,null, required)
    Placeholder text in the post creation form
    Example: {"en":"Describe your feature idea..."}

  - `localization.heroTitle` (object,null, required)
    Hero title shown on the board page
    Example: {"en":"Share your ideas"}

  - `localization.heroDescription` (object,null, required)
    Hero description/subtitle

  - `localization.submitButtonText` (object,null, required)
    Submit button text
    Example: {"en":"Submit Feedback"}

  - `createdAt` (string, required)
    ISO 8601 timestamp when created
    Example: "2023-12-12T00:00:00.000Z"

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "invalid_id"

  - `error.message` (string, required)
    Human-readable error message
    Example: "An error occurred"

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 400

## Response 404 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "board_not_found"

  - `error.message` (string, required)
    Human-readable error message
    Example: "An error occurred"

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 404