For dealers and distributors
Our stock, read straight from the source
If you buy from us regularly, you should not have to wait for a list by e-mail. Once your access is approved you read the available stock from the interface — the same data our warehouse works from.
Access
Three steps, one of them by hand
There is no self-service access. We approve every access individually — because behind the data sits our real stock with real prices.
1 · Application
A form with your company details and VAT identification number. We verify the number and match it to your company.
2 · Checked by hand
We look at who is asking and come back to you if anything is unclear. Usually decided by the next working day.
3 · Token
You receive a personal token by e-mail. It is valid until revoked and can be replaced at any time.
Documentation
Endpoints
Base address https://api.smd-tech.de/v1 · authentication through the header value X-API-Token · responses always JSON, character set UTF-8.
| Call | What it returns |
|---|---|
GET /bestand |
All available items. An item is the combination of model, storage, colour and grade — with the quantity that is genuinely available. |
GET /bestand/:artikel |
A single item by its identifier. |
GET /status |
Availability, the age of the data and your remaining request quota. Useful for checking a token. |
Filters for GET /bestand
| Parameter | Type | Effect |
|---|---|---|
typ | Text | Device type, for example smartphone,
tablet, notebook. |
modell | Text | Substring, case is ignored.
modell=iphone%2013 finds every variant. |
grade | Text | The grade. At present the interface only returns
A. |
farbe | Text | Colour as recorded in our stock, in German. |
min_menge | Integer | Only items with at least this available quantity. |
limit, offset | Integer | Paging. limit is 500 at most,
100 by default. |
Example
# Every available iPhone 13 with at least 5 units in stock curl -s 'https://api.smd-tech.de/v1/bestand?modell=iphone%2013&min_menge=5' \ -H 'X-API-Token: your-token'
{
"stand": "2026-07-25T18:40:12Z",
"anzahl": 2,
"artikel": [
{
"artikel": "iphone-13-128-schwarz-a",
"typ": "smartphone",
"modell": "Apple iPhone 13",
"speicher": "128 GB",
"farbe": "Schwarz",
"grade": "A",
"menge": 14,
"preis": 289.00,
"waehrung": "EUR"
}
]
}
Field names and values are German,
because they come out of our inventory system: stand is the time the data was
read, anzahl the number of items in the response, artikel the
list itself, speicher storage, farbe colour,
menge quantity, preis price and waehrung currency.
We keep them as they are rather than maintaining two sets of names that can drift
apart.
Rules
- Quota. 60 requests per minute and token. Above that the interface answers with
429and states how long to wait. - Quantity means available quantity. Anything reserved in an open order is not counted. That makes the figure dependable, but it can change at any moment — nothing is committed until we confirm your order.
- Prices are net prices in euros, excluding shipping, valid at the moment of the request. VAT follows the statutory rules.
- The token is yours alone. It must not end up in an application that runs in a browser, where anyone can read it. If you suspect it has leaked, we replace it straight away.
- Errors come as sentences. A
4xxresponse carries a fieldfehlerwith a readable explanation in German, not just a code.
Application
Request access
We only approve access for companies that actually intend to buy. Tell us briefly what you need the data for — that speeds up the check.
What we check
- That the VAT identification number is valid and matches the company name
- That there is a purchasing need we can make sense of
- That you are reachable on the contact details given
Already a customer?
If you already buy from us it goes faster — send a short note to info@smd-tech.de quoting your customer number.
Questions
Frequently asked about the interface
How current is the data?
A request reads straight from our inventory system. There is no cache that refreshes overnight — the time the data was read is in the field stand of every response.
Why grade A only?
Because we would rather start with one clear grade and keep the descriptions accurate. Other grades are available on request — talk to us and we will enable them for your token.
Can we place orders through the interface?
Not at the moment. The interface reads. Orders run through the shop or directly through your contact here. An ordering endpoint is planned — tell us if you need it, that shapes the order of work.
What happens during maintenance?
The interface answers with 503 and an indication of how long it is expected to last. Planned work is announced to access holders in advance.
Do we get images with the items?
Not through the interface. The shop holds model images. If you need images for your own shop, talk to us.
Buying on a regular basis?
Then the interface is the quietest route — your system asks, our warehouse answers.