---
title: "Returns a specific article"
method: GET
path: "/articles/{articleId}"
tags: ["Articles"]
---

# Returns a specific article

`GET /articles/{articleId}`

## Path parameters

- `articleId` integer, required

## Response `200`

Article

- object
  - `data` Article — An article object. Available relations: assignments, group, picture, changelog
    - `id` integer — ID
    - `first_line` string — First line
    - `icon` string — Icon
    - `color` string — Color
    - `contrast_color` 'dark' | 'white' — Contrast color
    - `custom_number` string — Custom number
    - `picture_is_avatar` boolean — Picture is avatar
    - `group_id` integer — Article group
    - `picture_id` integer — Photo
    - `name` string — Name
    - `manufacturer` string — Brand
    - `supplier_article_nr` string — Supplier article number
    - `manufacturer_article_nr` string — Article number
    - `ean` string — EAN
    - `unit` 'BAG' | 'BAR' | 'BOTTLE' | 'BOX' | 'BUCKET' | 'BUNCH' | 'CAN' | 'CANISTER' | 'CARDBOARD' | 'CUBIC_METRE' | 'CENTIMETERS' | 'CONTAINER' | 'DAYS' | 'DOZEN' | 'FLAT_FEE' | 'GRAMS' | 'HOURS' | 'KILOGRAMS' | 'KILOMETER' | 'KILOWATT_PEAK' | 'LITRE' | 'METRES' | 'MILLILITRE' | 'MILLIMETRES' | 'PACK' | 'PAIR' | 'PANEL' | 'PARCEL' | 'PERCENT' | 'PIECE' | 'ROLL' | 'RUNNING_METER' | 'SAC' | 'SET' | 'SQUAREMETER' | 'TONS' | 'TRIMMING' | 'TUBE' — Unit
    - `vat_included` '0' | '1' — VAT included
    - `unit_price` number, float — Price
    - `vat_rate` number, float — Vat rate
    - `currency` 'EUR' | 'USD' | 'CHF' | 'UAH' | 'PLN' | 'RON' — Currency
    - `price_date` string, date, nullable — Price date
    - `article_url` string — Article URL
    - `dangerous_material` boolean — Dangerous goods
    - `info` string — Detailed description
    - `source` string — Source
    - `source_external_id` string, nullable — Source ID
    - `created_at` string, date-time — Created
    - `updated_at` string, date-time — Updated

## Other responses

- `401` — The request lacks valid authentication credentials.
- `403` — The token is valid but lacks the permission for this action.
- `404` — The requested resource could not be found.
- `500` — An unexpected error occurred on the server (e.g. a requested relation does not exist).

---

[API](https://skmtc.net/craftboxx/apis/craftboxx-api-documentation.md) · [All operations](https://skmtc.net/craftboxx/apis/craftboxx-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/craftboxx/craftboxx-api-documentation/versions/c01f07a02f77/schema)