---
title: "Returns Block based on ID"
method: GET
path: "/{username}/dashboards/{dashboard_id}/blocks/{id}"
tags: ["Blocks"]
---

# Returns Block based on ID

`GET /{username}/dashboards/{dashboard_id}/blocks/{id}`

## Request

- Base URL: `https://io.adafruit.com/api/v2`
- URL: `https://io.adafruit.com/api/v2/{username}/dashboards/{dashboard_id}/blocks/{id}`
- Auth: one of:
  - API key in header `X-AIO-Key`
  - API key in header `X-AIO-Signature`
  - API key in query parameter `X-AIO-Key`

## Path parameters

- `username` string, required
- `dashboard_id` string, required
- `id` string, required

## Response `200`

Block response

- Block
  - `name` string
  - `description` string
  - `key` string
  - `visual_type` string
  - `column` number
  - `row` number
  - `size_x` number
  - `size_y` number
  - `block_feeds` BlockFeed[]
    - `id` string
    - `feed` Feed
      - `id` number
      - `name` string
      - `key` string
      - `group` object
      - `groups` ShallowGroup[]
        - `id` number
        - `name` string
        - `description` string
        - `created_at` string
        - `updated_at` string
      - `description` string
      - `details` object: Additional details about this feed.
        - `shared_with` object[]: Access control list for this feed
        - `data` object
          - `first` object
          - `last` object
          - `count` integer: Number of data points stored by this feed.
      - `unit_type` string
      - `unit_symbol` string
      - `history` boolean
      - `visibility` 'private' | 'public'
      - `license` string
      - `enabled` boolean
      - `last_value` string
      - `status` string
      - `status_notify` boolean: Is status notification active?
      - `status_timeout` integer: Status notification timeout in minutes.
      - `created_at` string
      - `updated_at` string
    - `group` Group
      - `id` number
      - `name` string
      - `description` string
      - `feeds` Feed[]
        - `id` number
        - `name` string
        - `key` string
        - `group` object
        - `groups` ShallowGroup[]
          - `id` number
          - `name` string
          - `description` string
          - `created_at` string
          - `updated_at` string
        - `description` string
        - `details` object: Additional details about this feed.
          - `shared_with` object[]: Access control list for this feed
          - `data` object
            - `first` object
            - `last` object
            - `count` integer: Number of data points stored by this feed.
        - `unit_type` string
        - `unit_symbol` string
        - `history` boolean
        - `visibility` 'private' | 'public'
        - `license` string
        - `enabled` boolean
        - `last_value` string
        - `status` string
        - `status_notify` boolean: Is status notification active?
        - `status_timeout` integer: Status notification timeout in minutes.
        - `created_at` string
        - `updated_at` string
      - `created_at` string
      - `updated_at` string

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Server Error"

## Changes

- **2016-09-08** (v2) `db91bfb03a83`: 1 info
  - added the non-success response with the status `401`
- **2016-08-24** (v2) `b2a6c239e1e0`: 1 info
  - api operation id `get` removed and replaced with `getBlock`
- **2016-08-24** (v2) `f6d4777c1f6c`: 1 info
  - api operation id `getBlock` removed and replaced with `get`
- **2016-08-22** (v2) `668394696f6e`: 1 info
  - api operation id `get` removed and replaced with `getBlock`
- **2016-08-18** (v2) `aaa52c04498a`: 1 breaking
  - added the new path request parameter `dashboard_id`

[Operation history](https://skmtc.dev/adafruit/apis/adafruit-io-rest-api/changes/:username/dashboards/:dashboard_id/blocks/:id/get.md)

---

[API](https://skmtc.dev/adafruit/apis/adafruit-io-rest-api.md) - [All operations](https://skmtc.dev/adafruit/apis/adafruit-io-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adafruit/apis/adafruit-io-rest-api/revisions/b16cd6123537?raw)