Widgets

Get widget

Retrieve a single widget by ID.

GET /api/v3/widgets/{id} Try It

Get widget

cURL
curl --request GET \
  --url https://api.example.com/v3/widgets/wdg_abc123 \
  --header 'Authorization: Bearer your-api-token'
200 application/json
{
  "id": "wdg_abc123",
  "name": "My first widget",
  "colour": "blue",
  "quantity": 12,
  "created_at": "2026-05-11T09:30:00Z",
  "updated_at": "2026-05-11T09:30:00Z"
}

Retrieve a single widget by ID.

Headers

  • Authorization string required header

    Bearer your-api-token

  • Accept string required header

    application/json

Path parameters

  • id string required path

    The widget's unique identifier (e.g. wdg_abc123).

Response codes

HTTP status
  • 200

    Returns the widget.

  • 401

    Unauthorized — invalid or missing API token.

  • 404

    Not found — widget does not exist.