Skip to main content
GET
List Articles
plots lists the distinct plots of the article without geometry, at most 1000 entries (ordered by id); plotsTruncated: true means more exist. Fetch a plot’s geometry via GET /api/v1/plots/{id}. supplierLinks lists the article’s supplier links as [{ supplierId, supplierArticleId }] ([] when the article has no supplier). supplierArticleId addresses the article for exactly one supplier — pass it in supplierArticleIds of POST /api/v1/plots and as supplierArticleId to GET /api/v1/evidence. The article embedded in order lines carries the same field. See Per-order origin via ERP.

Authorizations

Authorization
string
header
required

API key generated in Settings > API Keys. Include as Authorization: Bearer <key>.

Query Parameters

internalArticleNr
string

Filter by internal article number (ERP ID), exact match. A per-order copy of an article is <internalArticleNr>#<orderNumber> — encode # as %23.

externalArticleNr
string

Filter by external article number

hsCode
string

Filter by HS code

externalSupplierId
string

Filter by the supplier number from your ERP (externalSupplierId) of a supplier linked to the article

orderNumber
string

Filter by order number: articles on a line of that order

species
string

Filter by species: articles with a linked plot naming this scientific name (exact match)

commodityGroup
enum<string>

Filter by commodity group

Available options:
cattle,
cocoa,
coffee,
oil_palm,
rubber,
soya,
wood,
non_relevant
articleType
enum<string>

Filter by article type

Available options:
purchase,
sale
eudrRelevant
enum<string>

Filter by EUDR relevance

Available options:
true,
false
limit
integer
default:100

Maximum number of results to return (default 100, max 1000).

Required range: 1 <= x <= 1000
offset
integer | null
default:0

Number of results to skip for pagination.

Required range: x >= 0
fields
string

Comma-separated list of the resource's top-level keys to return (per element for a list), e.g. id,name; omit for the full body. Top-level only; whitespace is trimmed and duplicates count once. fields never adds keys: a selected optional key that is absent on a row stays absent. 400 when passed more than once, when empty, or when it names an unknown key (the error names it and lists the allowed ones).

Response

List of articles

id
string
required

UUID of the article.

name
string
required

Article name.

shortDescription
string
required

Short description of the article; empty string when none was given.

internalArticleNr
string
required

Internal article number (your ERP ID), unique per company. A per-order copy of an article carries <internalArticleNr>#<orderNumber>; the number to show to people is externalArticleNr when set, else internalArticleNr.

externalArticleNr
string | null
required

External article number, e.g. a supplier's or customer's number. On a per-order copy it holds the original article's internalArticleNr.

ean
string | null
required

EAN / GTIN barcode, or null.

hsCode
string
required

Harmonized System code

articleType
string
required

purchase (bought from a supplier) or sale (sold by your company).

eudrRelevant
boolean
required

Automatically determined from HS code

needsManualCheck
boolean
required

true when the EUDR classification derived from the HS code should be checked by a person.

sourceScope
string
required

standing: the article's source is fixed. perOrder: the article is a template whose source varies per order; order import creates one copy per order from it.

hsPlausibility
object | null
required

Stored result of an advisory check of the HS code against the article description, or null when not checked. Stored only: it never warns about or blocks a create or update. The object's shape is not part of the v1 contract and may change — do not depend on it.

suppliers
object[]
required

The suppliers linked to the article. Embedded suppliers carry empty articles and plots.

plots
object[]
required

Distinct plots of the article without geometry, at most 1000 (ordered by id); fetch geometry via GET /plots/{id}.

complianceResults
object[]
required

The EUDR compliance result per supplier link of the article.

geoComplianceResults
any[]
required

Geolocation compliance details. Present, but the item shape is not part of the v1 contract and may change — do not depend on it.

Legal compliance details. Present, but the item shape is not part of the v1 contract and may change — do not depend on it.

Legal documents on record. Present, but the item shape is not part of the v1 contract and may change — do not depend on it.

Per-category legal compliance results. Present, but the item shape is not part of the v1 contract and may change — do not depend on it.

questionnaires
any[]
required

Supplier questionnaire responses. Present, but the item shape is not part of the v1 contract and may change — do not depend on it.

countryOfProduction
string[] | null
required

Countries of production declared on one of the article's supplier links (which one is not specified), or null.

commodityGroup
string
required

EUDR commodity group, derived from the HS code unless set explicitly. One of the CommodityGroup values.

weightPerPieceKg
number | null
required

Weight of one piece in kg, used to derive net mass from a piece count; null when unknown.

deletedAt
string | null
required

When the article was moved to the trash (ISO 8601, UTC); null for a live article.

plotsTruncated
boolean
required

true when the article has more than 1000 distinct plots and plots holds only the first 1000 by id.

certifications
any[]

Certifications (e.g. FSC, PEFC) on record for the article; absent when the article has no supplier link. Present, but the item shape is not part of the v1 contract and may change — do not depend on it.

ownSupplierArticleIds
string[]

UUIDs of the article's own supplier articles (one per linked supplier); absent when the article has no supplier link.

The article's supplier links. supplierArticleId addresses this article for one supplier: pass it in supplierArticleIds of POST /api/v1/plots. Present on the article endpoints and on order-line articles; [] when the article has no supplier.

inputArticles
any[]

Upstream input articles recorded for the article's supply chain; absent when there are none. Present, but the item shape is not part of the v1 contract and may change — do not depend on it.