PIM API reference
Wines, offers and listings — the product-information endpoints.
PIM API reference
The product-information surface. All reads are cursor-paginated (page_size default 50, max 200;
cursor; has_more) and constrained by the data-exposure controls.
Base URL: https://api.wine2you.shop · Auth: Authorization: Bearer <key>
Wines
| Method | Path | Purpose |
|---|---|---|
POST |
/v1/wines/match |
dedupe a candidate against the canonical register |
POST |
/v1/wines |
create a canonical wine |
GET |
/v1/wines |
list wines your entity may see |
GET |
/v1/wines/{id} |
retrieve one wine |
Offers
| Method | Path | Purpose |
|---|---|---|
POST |
/v1/offers |
create an offer (stock + seller price + permissions) |
GET |
/v1/offers |
list offers your entity is permitted to see |
GET |
/v1/offers/{id} |
retrieve one offer |
PATCH |
/v1/offers/{id} |
update stock / price / permissions |
Listings
| Method | Path | Purpose |
|---|---|---|
POST |
/v1/listings |
create a listing on a permitted offer |
GET |
/v1/listings |
list your listings |
PATCH |
/v1/listings/{id} |
update shelf price |
DELETE |
/v1/listings/{id} |
remove a listing |
Channels
| Method | Path | Purpose |
|---|---|---|
POST |
/v1/channels |
create a storefront/tenant |
POST |
/v1/channels/{id}/publish |
publish listings to a channel |
Pagination envelope
{ "data": [ … ], "page_size": 50, "cursor": "eyJ…", "has_more": true }
There is no total-count field — a caller cannot learn the size of a table from a response.
Related
- Full model + field names: PIM Product API taxonomy
- Controls on every read: Data-exposure controls