---
title: "Find articles by article numbers"
method: GET
path: "/core/latest/articles/article-numbers"
tags: ["Article"]
---

# Find articles by article numbers

`GET /core/latest/articles/article-numbers`

## Request

- Base URL: `https://api.klara.ch`
- URL: `https://api.klara.ch/core/latest/articles/article-numbers`
- Auth: one of:
  - API key in header `X-API-KEY`
  - HTTP bearer

Batch-resolve a list of article numbers to their priced article rows of the caller's company. Returns each row enriched with the price valid on `price-date` and the appropriate VAT rate. Unknown article numbers are silently skipped (returned list contains only matching rows). Requires permission `ARTICLE_READ_ONLY`.

## Query parameters

- `article-numbers` unknown[]
  - unknown
- `export-vat` boolean
- `price-date` string, date
- `should-validate-vat` boolean

## Response `200`

Matching articles

- ArticleAndVariant[]
  - `id` string: Id of the article
  - `name` string: Name of the article
  - `description` string: Description for the article
  - `extendedDescription` string: This description will be used for example in your online shop
  - `unit` string: Define how the article is count by
  - `barcode` string: Barcode of the article
  - `defaultQuantity` number: The default quantity of the article
  - `accountingTags` string[]: Tags used for accounting. Articles with the same tag, same VAT case and same VAT rate are grouped together in the posting
  - `articleNumber` string: Number of the article
  - `productType` 'SERVICE' | 'PRODUCTION' | 'TRADE' | 'OTHER' | 'GIFT_CARD' | 'PREPAYMENT': The product type of the article
  - `priceCategories` ArticlePriceCategory[]: Price categories of the article
    - `name` string
    - `priceIncludeVat` number
    - `priceExcludeVat` number
  - `vatRate` number: Vat rate of the article
  - `articleType` 'ARTICLE' | 'ARTICLE_SET' | 'VARIANT': Article type
  - `priceIncludeVat` number: price include vat
  - `priceExcludeVat` number: price exclude vat
  - `hasInventory` boolean: This article has inventory or not
  - `quantityInStock` number: Quantity in stock
  - `optionValues` string[]: Variant option of this article
  - `ableToOrderOutOfStock` boolean: Flag define the article is allow to order out of stock

## Other responses

- `400`: Data invalid<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `401`: No Authorization header found or invalid token<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `403`: The current user is not allowed to access this company data<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `429`: API rate limit exceeded<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `500`: Something went wrong on our side while processing the request. Please kindly contact our support.<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.

---

[API](https://skmtc.dev/klara/apis/klara-public-api.md) · [All operations](https://skmtc.dev/klara/apis/klara-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/klara/apis/klara-public-api/revisions/490b1a879fc2?raw)