{"components":{"schemas":{"Account":{"additionalProperties":false,"properties":{"activated_at":{"anyOf":[{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},{"type":"null"}]},"allowances":{"additionalProperties":false,"description":"Null: unlimited.","properties":{"api_requests_per_month":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]},"linked_variants":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]}},"required":["linked_variants","api_requests_per_month"],"type":"object"},"billing_email":{"type":"string"},"cancel_at":{"anyOf":[{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},{"type":"null"}]},"complimentary":{"description":"No charge: true when the partner gave free access, or Presslane Suppliers made the account complimentary.","type":"boolean"},"created_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"ended_at":{"anyOf":[{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},{"type":"null"}]},"external_ref":{"description":"The partner's tenant ID.","type":"string"},"free_access":{"description":"The partner gave this tenant free access on its free plan (PATCH free_access). The partner can end it; a complimentary account Presslane Suppliers set has `complimentary: true` and `free_access: false`, and only Presslane Suppliers can end it.","type":"boolean"},"id":{"example":"acc_01jd6y…","type":"string"},"name":{"type":"string"},"plan":{"anyOf":[{"additionalProperties":false,"properties":{"code":{"type":"string"},"name":{"type":"string"}},"required":["code","name"],"type":"object"},{"type":"null"}]},"sandbox":{"description":"A sandbox account, for trying the API: it reads the real catalogue and stock, but its orders are only ever recorded as tests (status `test`) and never sent to a supplier. Only Presslane Suppliers sets it.","type":"boolean"},"scheduled_plan":{"anyOf":[{"additionalProperties":false,"properties":{"code":{"type":"string"},"from":{"anyOf":[{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},{"type":"null"}]},"name":{"type":"string"}},"required":["code","name","from"],"type":"object"},{"type":"null"}],"description":"A downgrade waiting for the period end."},"status":{"$ref":"#/components/schemas/AccountStatus"},"subscription":{"anyOf":[{"additionalProperties":false,"properties":{"cancel_at_period_end":{"type":"boolean"},"current_period_end":{"anyOf":[{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},{"type":"null"}]},"last_payment_error":{"type":["string","null"]},"price":{"anyOf":[{"additionalProperties":false,"properties":{"amount_minor":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"currency":{"type":"string"},"interval":{"const":"month","type":"string"}},"required":["amount_minor","currency","interval"],"type":"object"},{"type":"null"}]},"status":{"type":["string","null"]},"trial_end":{"anyOf":[{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},{"type":"null"}]}},"required":["status","price","current_period_end","trial_end","cancel_at_period_end","last_payment_error"],"type":"object"},{"type":"null"}]},"suspended_reason":{"anyOf":[{"enum":["unpaid","cancelled","locked","manual"],"type":"string"},{"type":"null"}]},"usage":{"additionalProperties":false,"properties":{"api_requests":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"linked_variants":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"period_end":{"example":"2026-11-21","format":"date","type":"string"},"period_start":{"example":"2026-11-21","format":"date","type":"string"}},"required":["period_start","period_end","linked_variants","api_requests"],"type":"object"}},"required":["id","external_ref","name","billing_email","status","suspended_reason","complimentary","free_access","sandbox","plan","scheduled_plan","subscription","allowances","usage","activated_at","cancel_at","ended_at","created_at"],"type":"object"},"AccountCreateRequest":{"properties":{"billing_email":{"format":"email","type":"string"},"cancel_url":{"description":"Required unless `free_access` is true.","format":"uri","type":"string"},"external_ref":{"description":"The partner's tenant ID. One account per tenant.","type":"string"},"free_access":{"description":"true: the tenant uses the API free, on the free plan Presslane Suppliers set up for the partner (the plan in GET /v1/plans with `free_access: true`). The account is active at once and there is no Checkout. 403 if the partner has no free plan.","type":"boolean"},"name":{"description":"Business name.","type":"string"},"plan":{"description":"Plan code from GET /v1/plans. Required unless `free_access` is true.","example":"starter","type":"string"},"success_url":{"description":"Where Stripe sends the tenant after paying. Must start with one of the partner's allowed return URLs. Required unless `free_access` is true.","format":"uri","type":"string"}},"required":["external_ref","name","billing_email"],"type":"object"},"AccountCreateResponse":{"additionalProperties":false,"properties":{"account":{"$ref":"#/components/schemas/Account"},"checkout_expires_at":{"anyOf":[{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},{"type":"null"}]},"checkout_url":{"description":"Stripe Checkout. Null when no payment is needed (already active, free access, complimentary or a free plan).","type":["string","null"]}},"required":["account","checkout_url","checkout_expires_at"],"type":"object"},"AccountPatchRequest":{"properties":{"billing_email":{"type":"string"},"cancel_at_period_end":{"description":"true when the tenant switches the module off.","type":"boolean"},"free_access":{"description":"true: the tenant uses the API free, on the partner's free plan; a subscription it pays is paused (no charge). false: it pays again: a paused subscription resumes on its own plan and the status follows Stripe; with none, the account goes to `pending_payment` (data endpoints stop) until the tenant pays through Checkout (POST /v1/accounts with a plan). Not with `plan` in the same request.","type":"boolean"},"name":{"type":"string"},"plan":{"description":"Upgrades take effect now with proration; downgrades at the next period, if linked variants fit.","type":"string"},"suspended":{"description":"true: the platform lock — suspends at once and stops billing. false: resume.","type":"boolean"}},"type":"object"},"AccountStatus":{"description":"`active` and `past_due` can use data endpoints; others answer 403 `account_suspended`.","enum":["pending_payment","active","past_due","suspended","cancelled","closed"],"type":"string"},"AccountSupplier":{"additionalProperties":false,"properties":{"api":{"anyOf":[{"additionalProperties":false,"properties":{"connection":{"anyOf":[{"additionalProperties":false,"properties":{"last_checked_at":{"anyOf":[{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},{"type":"null"}]},"status":{"enum":["unverified","verified","failed"],"type":"string"}},"required":["status","last_checked_at"],"type":"object"},{"type":"null"}],"description":"The account's stored login at the supplier; null until one is sent."},"credential_fields":{"description":"What to ask the business for: its API login at the supplier.","items":{"$ref":"#/components/schemas/CredentialField"},"type":"array"},"features":{"items":{"$ref":"#/components/schemas/ApiFeature"},"type":"array"},"needs_credentials":{"description":"True while no working login is stored (none yet, or the supplier refused it): ask the business for one and send it as `api_credentials`.","type":"boolean"},"order_mode":{"$ref":"#/components/schemas/OrderMode"}},"required":["features","order_mode","credential_fields","needs_credentials","connection"],"type":"object"},{"type":"null"}],"description":"The supplier's API, when it offers one through Presslane Suppliers (ADR-011). Null: stock from feeds only, no login needed."},"created_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"name":{"type":"string"},"needs_trade_account":{"description":"Stock is shown only once a trade account number is given.","type":"boolean"},"slug":{"type":"string"},"supplier_archived":{"type":"boolean"},"supplier_id":{"type":"string"},"trade_account_number":{"type":["string","null"]},"updated_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"}},"required":["supplier_id","slug","name","needs_trade_account","trade_account_number","supplier_archived","api","created_at","updated_at"],"type":"object"},"AccountSupplierList":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/AccountSupplier"},"type":"array"}},"required":["data"],"type":"object"},"AccountSupplierPutRequest":{"properties":{"api_credentials":{"$ref":"#/components/schemas/ApiCredentials","description":"Where the supplier offers API access: the business’s login there. Left out: any stored login is kept. Needs `orders:write`."},"trade_account_number":{"description":"Left out: kept as it is. Null or empty: cleared.","type":["string","null"]}},"type":"object"},"AccountSuppliersPutRequest":{"description":"The whole list: suppliers not listed are removed, with their stored logins.","properties":{"suppliers":{"items":{"properties":{"api_credentials":{"$ref":"#/components/schemas/ApiCredentials","description":"Only for suppliers with `api_credential_fields`. Left out: any stored login is kept. Needs `orders:write`."},"supplier_id":{"type":"string"},"trade_account_number":{"type":["string","null"]}},"required":["supplier_id"],"type":"object"},"maxItems":200,"type":"array"}},"required":["suppliers"],"type":"object"},"ApiCredentials":{"additionalProperties":{"type":"string"},"description":"The business's own API login at the supplier, keyed as the supplier's `api_credential_fields` say (Uneek Clothing and Ralawise: `username`, `password`; for Ralawise, a website login Ralawise has enabled for its API; PenCarrie: `customer_code`, which Presslane Suppliers must have approved for this account, else 403 `forbidden` and nothing is sent; Absolute Apparel: `api_key`, the API key Absolute Apparel issued for the trade account). Checked with a harmless read at the supplier before it is saved; a login the supplier refuses is not saved (409 `supplier_auth_failed`). Stored encrypted and never returned.","example":{"password":"secret","username":"standardprint-api"},"propertyNames":{"type":"string"},"type":"object"},"ApiFeature":{"description":"What a supplier's API offers through Presslane Suppliers, with the account's own login: `place_orders`, `order_history` (all the account's orders at the supplier), `invoices`, `live_stock` (stock straight from the supplier). Suppliers without an API offer none.","enum":["place_orders","order_history","invoices","live_stock"],"type":"string"},"AvailabilityLookupRequest":{"properties":{"include":{"items":{"enum":["locations"],"type":"string"},"type":"array"},"items":{"items":{"$ref":"#/components/schemas/VariantIdentifier"},"maxItems":500,"minItems":1,"type":"array"},"location":{"description":"Totals over one location code instead of all.","maxLength":20,"minLength":1,"type":"string"}},"required":["items"],"type":"object"},"AvailabilityLookupResponse":{"additionalProperties":false,"properties":{"data":{"items":{"additionalProperties":false,"properties":{"as_of":{"description":"The older of the supplier's timestamp and the load time across the locations used.","example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"available":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}],"description":"Null when the supplier gives a band, or quantities are withheld."},"band":{"description":"The supplier's band text, when banded.","type":["string","null"]},"colour":{"type":["string","null"]},"external_ref":{"type":["string","null"]},"lead_time_days":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]},"locations":{"description":"With `include: [\"locations\"]`.","items":{"$ref":"#/components/schemas/LocationAvailability"},"type":"array"},"next_incoming":{"anyOf":[{"$ref":"#/components/schemas/Incoming"},{"type":"null"}]},"product_code":{"type":"string"},"product_id":{"type":"string"},"quantity_at_least":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}],"description":"Lower bound when stock is banded (\"50+\")."},"request_index":{"description":"Index of the identifier in `items`.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"size":{"type":["string","null"]},"stale":{"type":"boolean"},"status":{"$ref":"#/components/schemas/StockStatus"},"supplier":{"$ref":"#/components/schemas/SupplierRef"},"supplier_sku":{"type":"string"},"variant_id":{"type":"string"}},"required":["variant_id","supplier","supplier_sku","product_id","product_code","colour","size","status","available","quantity_at_least","band","next_incoming","lead_time_days","as_of","stale","request_index","external_ref"],"type":"object"},"type":"array"},"not_found":{"description":"The identifiers that matched nothing, with `request_index`.","items":{"additionalProperties":{},"propertyNames":{"type":"string"},"type":"object"},"type":"array"}},"required":["data","not_found"],"type":"object"},"BillingPortalRequest":{"properties":{"return_url":{"format":"uri","type":"string"}},"required":["return_url"],"type":"object"},"BillingPortalResponse":{"additionalProperties":false,"properties":{"url":{"format":"uri","type":"string"}},"required":["url"],"type":"object"},"ByExternalRef":{"additionalProperties":false,"description":"The account's own variant reference.","properties":{"external_ref":{"description":"The account's own variant reference, through its links.","maxLength":200,"minLength":1,"type":"string"}},"required":["external_ref"],"type":"object"},"ByExternalRefLine":{"additionalProperties":false,"description":"The account's own variant reference.","properties":{"external_ref":{"description":"The account's own variant reference, through its links.","maxLength":200,"minLength":1,"type":"string"},"quantity":{"maximum":10000000,"minimum":1,"type":"integer"}},"required":["external_ref","quantity"],"type":"object"},"ByGtin":{"additionalProperties":false,"description":"A GTIN.","properties":{"gtin":{"description":"A GTIN (8–14 digits); leading zeros are matched loosely.","pattern":"^\\d{8,14}$","type":"string"}},"required":["gtin"],"type":"object"},"ByGtinLine":{"additionalProperties":false,"description":"A GTIN.","properties":{"gtin":{"description":"A GTIN (8–14 digits); leading zeros are matched loosely.","pattern":"^\\d{8,14}$","type":"string"},"quantity":{"maximum":10000000,"minimum":1,"type":"integer"}},"required":["gtin","quantity"],"type":"object"},"BySupplierSku":{"additionalProperties":false,"description":"A supplier and that supplier's SKU.","properties":{"supplier":{"description":"Supplier ID or slug.","maxLength":100,"minLength":1,"type":"string"},"supplier_sku":{"maxLength":100,"minLength":1,"type":"string"}},"required":["supplier","supplier_sku"],"type":"object"},"BySupplierSkuLine":{"additionalProperties":false,"description":"A supplier and that supplier's SKU.","properties":{"quantity":{"maximum":10000000,"minimum":1,"type":"integer"},"supplier":{"description":"Supplier ID or slug.","maxLength":100,"minLength":1,"type":"string"},"supplier_sku":{"maxLength":100,"minLength":1,"type":"string"}},"required":["supplier","supplier_sku","quantity"],"type":"object"},"ByVariantId":{"additionalProperties":false,"description":"A Presslane Suppliers variant ID.","properties":{"variant_id":{"maxLength":100,"minLength":1,"type":"string"}},"required":["variant_id"],"type":"object"},"ByVariantIdLine":{"additionalProperties":false,"description":"A Presslane Suppliers variant ID.","properties":{"quantity":{"maximum":10000000,"minimum":1,"type":"integer"},"variant_id":{"maxLength":100,"minLength":1,"type":"string"}},"required":["variant_id","quantity"],"type":"object"},"ClientCreateRequest":{"properties":{"name":{"type":"string"},"scopes":{"description":"Default: every account scope.","items":{"enum":["catalogue:read","stock:read","links:write","links:read","webhooks:write","usage:read","orders:write","orders:read"],"type":"string"},"type":"array"}},"type":"object"},"ClientCredentials":{"additionalProperties":false,"properties":{"client_id":{"type":"string"},"client_secret":{"description":"Returned once, when created. Store it encrypted.","type":"string"},"created_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"name":{"type":"string"},"revoked_at":{"anyOf":[{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},{"type":"null"}]},"scopes":{"items":{"type":"string"},"type":"array"},"status":{"enum":["active","revoked"],"type":"string"}},"required":["client_id","name","scopes","status","created_at","revoked_at"],"type":"object"},"CredentialField":{"additionalProperties":false,"description":"A field of a supplier's API login.","properties":{"help":{"type":["string","null"]},"key":{"description":"The key to send in `api_credentials`.","example":"username","type":"string"},"label":{"description":"What to call it when asking the business.","example":"Uneek API username","type":"string"},"required":{"type":"boolean"},"type":{"description":"`password`: secret; mask it when asking, and it is never shown back.","enum":["text","password"],"type":"string"}},"required":["key","label","type","required","help"],"type":"object"},"EventType":{"enum":["account.activated","account.updated","account.suspended","account.cancelled","stock.changed","stock.low","stock.out","stock.back","supplier.updated","supplier.sync_failed","usage.threshold"],"type":"string"},"Incoming":{"additionalProperties":false,"properties":{"expected_on":{"example":"2026-11-21","format":"date","type":"string"},"quantity":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["quantity","expected_on"],"type":"object"},"IntrospectionResponse":{"additionalProperties":false,"properties":{"account_id":{"type":"string"},"active":{"type":"boolean"},"aud":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"client_id":{"type":"string"},"exp":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"iat":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"iss":{"type":"string"},"jti":{"type":"string"},"kind":{"enum":["partner","account","supplier"],"type":"string"},"scope":{"type":"string"},"sub":{"type":"string"},"token_type":{"type":"string"}},"required":["active"],"type":"object"},"Link":{"additionalProperties":false,"properties":{"confidence":{"type":["number","null"]},"created_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"external_ref":{"description":"The account's own variant reference (the platform's product_variants.id).","type":"string"},"id":{"example":"lnk_01jd…","type":"string"},"match_method":{"enum":["gtin","strong","weak","manual"],"type":"string"},"supplier_id":{"type":"string"},"supplier_sku":{"type":"string"},"supplier_variant_id":{"type":"string"},"updated_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"}},"required":["id","external_ref","supplier_variant_id","supplier_id","supplier_sku","match_method","confidence","created_at","updated_at"],"type":"object"},"LinkList":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/Link"},"type":"array"},"has_more":{"type":"boolean"},"next_cursor":{"description":"Pass as `starting_after` for the next page.","type":["string","null"]}},"required":["data","has_more","next_cursor"],"type":"object"},"LinksPutRequest":{"properties":{"links":{"items":{"properties":{"external_ref":{"type":"string"},"variants":{"description":"The full set for this ref: links not listed are removed; an empty list removes them all.","items":{"properties":{"confidence":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}]},"match_method":{"description":"Default manual.","enum":["gtin","strong","weak","manual"],"type":"string"},"supplier_variant_id":{"type":"string"}},"required":["supplier_variant_id"],"type":"object"},"type":"array"}},"required":["external_ref","variants"],"type":"object"},"maxItems":1000,"minItems":1,"type":"array"}},"required":["links"],"type":"object"},"LinksPutResponse":{"additionalProperties":false,"properties":{"created":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"data":{"description":"The links of the refs sent.","items":{"$ref":"#/components/schemas/Link"},"type":"array"},"linked_variants":{"description":"Distinct external_refs with a link, after the change.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"removed":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"updated":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["created","updated","removed","linked_variants","data"],"type":"object"},"Location":{"additionalProperties":false,"properties":{"code":{"example":"MAIN","type":"string"},"country":{"type":"string"},"is_default":{"type":"boolean"},"name":{"type":"string"}},"required":["code","name","country","is_default"],"type":"object"},"LocationAvailability":{"additionalProperties":false,"properties":{"available":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]},"band":{"type":["string","null"]},"code":{"type":"string"},"incoming":{"description":"Up to the three soonest deliveries.","items":{"$ref":"#/components/schemas/Incoming"},"type":"array"},"quantity_at_least":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]}},"required":["code","available","quantity_at_least","band","incoming"],"type":"object"},"MatchRequest":{"properties":{"limit":{"description":"Suggestions per variant (default 5).","maximum":10,"minimum":1,"type":"integer"},"suppliers":{"description":"Supplier IDs to search. Default: the account's suppliers, else all.","items":{"type":"string"},"type":"array"},"variants":{"items":{"properties":{"brand":{"type":["string","null"]},"colour":{"type":["string","null"]},"external_ref":{"type":"string"},"gtin":{"type":["string","null"]},"product_code":{"type":["string","null"]},"product_name":{"type":["string","null"]},"size":{"type":["string","null"]},"sku":{"type":["string","null"]},"supplier_code":{"description":"The tenant's code for this product at the supplier.","type":["string","null"]}},"required":["external_ref"],"type":"object"},"maxItems":500,"minItems":1,"type":"array"}},"required":["variants"],"type":"object"},"MatchResponse":{"additionalProperties":false,"properties":{"data":{"items":{"additionalProperties":false,"properties":{"external_ref":{"type":"string"},"suggestions":{"items":{"$ref":"#/components/schemas/MatchSuggestion"},"type":"array"}},"required":["external_ref","suggestions"],"type":"object"},"type":"array"}},"required":["data"],"type":"object"},"MatchSuggestion":{"additionalProperties":false,"properties":{"brand":{"type":["string","null"]},"colour":{"type":["string","null"]},"confidence":{"description":"gtin 1.0; strong 0.85–0.95; weak at most 0.6.","type":"number"},"gtin":{"type":["string","null"]},"match_method":{"enum":["gtin","strong","weak"],"type":"string"},"product_code":{"type":"string"},"product_id":{"type":"string"},"product_name":{"type":"string"},"size":{"type":["string","null"]},"supplier_id":{"type":"string"},"supplier_sku":{"type":"string"},"supplier_variant_id":{"type":"string"}},"required":["supplier_variant_id","supplier_id","supplier_sku","product_id","product_code","product_name","brand","colour","size","gtin","match_method","confidence"],"type":"object"},"Money":{"additionalProperties":false,"properties":{"amount_minor":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"currency":{"type":"string"}},"required":["amount_minor","currency"],"type":"object"},"OAuthError":{"additionalProperties":false,"description":"RFC 6749 §5.2 error response.","properties":{"error":{"enum":["invalid_request","invalid_client","invalid_grant","invalid_scope","unsupported_grant_type","rate_limited"],"type":"string"},"error_description":{"type":"string"}},"required":["error","error_description"],"type":"object"},"Order":{"additionalProperties":false,"properties":{"contact_email":{"type":["string","null"]},"contact_name":{"type":["string","null"]},"contact_phone":{"type":["string","null"]},"created_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"delivery":{"anyOf":[{"$ref":"#/components/schemas/OrderDeliveryOutput"},{"type":"null"}]},"error":{"type":["string","null"]},"id":{"example":"ord_01jd…","type":"string"},"lines":{"items":{"$ref":"#/components/schemas/OrderLine"},"type":"array"},"mode":{"enum":["test","live"],"type":"string"},"notes":{"type":["string","null"]},"reference":{"description":"The account's reference; the supplier's purchase order number.","type":"string"},"special_instructions":{"type":["string","null"]},"status":{"description":"`test`: recorded, not sent. `submitted`: the supplier took it. `failed`: the supplier did not take it (see `error`); fix and send again. `unconfirmed`: no clear answer; check with GET /v1/orders/{id}?refresh=true before sending again. `pending`: being sent.","enum":["test","pending","submitted","unconfirmed","failed"],"type":"string"},"submitted_at":{"anyOf":[{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},{"type":"null"}]},"supplier_id":{"type":"string"},"supplier_order_ref":{"description":"The supplier's own order number, when it gives one.","type":["string","null"]},"supplier_request":{"description":"The exact body sent to the supplier, or that test mode would have sent. Never holds credentials."},"supplier_response":{"description":"The supplier's answer, when there was one."},"updated_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"warnings":{"description":"What the supplier said about an order it took, e.g. Ralawise's `SkuNotFound` (that line was not ordered) or `UnableToAllocateSku` (less was allocated than ordered, on a line without back-ordering). Empty otherwise.","example":["UnableToAllocateSku: The SKU requested (GD057INBLS) was not found in sufficient quantity to satisfy the order. Ordered: 10, allocated: 7 (SKU)"],"items":{"type":"string"},"type":"array"}},"required":["id","supplier_id","reference","mode","status","supplier_order_ref","lines","delivery","contact_email","contact_name","contact_phone","notes","special_instructions","error","warnings","supplier_request","supplier_response","submitted_at","created_at","updated_at"],"type":"object"},"OrderDelivery":{"properties":{"city":{"type":"string"},"country_code":{"example":"GB","type":"string"},"country_name":{"type":["string","null"]},"line1":{"type":"string"},"line2":{"type":["string","null"]},"method":{"description":"The supplier's delivery method code; empty for its default (Absolute Apparel: the default delivery code Presslane Suppliers set, as it needs one on every order).","type":["string","null"]},"name":{"description":"Who or which business receives it.","type":"string"},"plain_cover":{"description":"Ship without the supplier's branding (default false).","type":"boolean"},"postcode":{"type":"string"}},"required":["name","line1","city","postcode","country_code"],"type":"object"},"OrderDeliveryOutput":{"additionalProperties":false,"properties":{"city":{"type":"string"},"country_code":{"example":"GB","type":"string"},"country_name":{"type":["string","null"]},"line1":{"type":"string"},"line2":{"type":["string","null"]},"method":{"description":"The supplier's delivery method code; empty for its default (Absolute Apparel: the default delivery code Presslane Suppliers set, as it needs one on every order).","type":["string","null"]},"name":{"description":"Who or which business receives it.","type":"string"},"plain_cover":{"description":"Ship without the supplier's branding (default false).","type":"boolean"},"postcode":{"type":"string"}},"required":["name","line1","city","postcode","country_code"],"type":"object"},"OrderDetail":{"additionalProperties":false,"properties":{"contact_email":{"type":["string","null"]},"contact_name":{"type":["string","null"]},"contact_phone":{"type":["string","null"]},"created_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"delivery":{"anyOf":[{"$ref":"#/components/schemas/OrderDeliveryOutput"},{"type":"null"}]},"error":{"type":["string","null"]},"id":{"example":"ord_01jd…","type":"string"},"lines":{"items":{"$ref":"#/components/schemas/OrderLine"},"type":"array"},"mode":{"enum":["test","live"],"type":"string"},"notes":{"type":["string","null"]},"reference":{"description":"The account's reference; the supplier's purchase order number.","type":"string"},"special_instructions":{"type":["string","null"]},"status":{"description":"`test`: recorded, not sent. `submitted`: the supplier took it. `failed`: the supplier did not take it (see `error`); fix and send again. `unconfirmed`: no clear answer; check with GET /v1/orders/{id}?refresh=true before sending again. `pending`: being sent.","enum":["test","pending","submitted","unconfirmed","failed"],"type":"string"},"submitted_at":{"anyOf":[{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},{"type":"null"}]},"supplier_id":{"type":"string"},"supplier_order":{"anyOf":[{"$ref":"#/components/schemas/SupplierOrder"},{"type":"null"}],"description":"With `refresh=true` on a live order: the supplier’s view of it."},"supplier_order_ref":{"description":"The supplier's own order number, when it gives one.","type":["string","null"]},"supplier_request":{"description":"The exact body sent to the supplier, or that test mode would have sent. Never holds credentials."},"supplier_response":{"description":"The supplier's answer, when there was one."},"updated_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"warnings":{"description":"What the supplier said about an order it took, e.g. Ralawise's `SkuNotFound` (that line was not ordered) or `UnableToAllocateSku` (less was allocated than ordered, on a line without back-ordering). Empty otherwise.","example":["UnableToAllocateSku: The SKU requested (GD057INBLS) was not found in sufficient quantity to satisfy the order. Ordered: 10, allocated: 7 (SKU)"],"items":{"type":"string"},"type":"array"}},"required":["id","supplier_id","reference","mode","status","supplier_order_ref","lines","delivery","contact_email","contact_name","contact_phone","notes","special_instructions","error","warnings","supplier_request","supplier_response","submitted_at","created_at","updated_at","supplier_order"],"type":"object"},"OrderLine":{"additionalProperties":false,"properties":{"allow_backorder":{"type":"boolean"},"line_ref":{"type":"string"},"quantity":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"supplier_sku":{"description":"The supplier's own code for the item, as sent.","type":"string"},"supplier_variant_id":{"type":["string","null"]}},"required":["line_ref","supplier_variant_id","supplier_sku","quantity","allow_backorder"],"type":"object"},"OrderList":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/Order"},"type":"array"},"has_more":{"type":"boolean"},"next_cursor":{"description":"Pass as `starting_after` for the next page.","type":["string","null"]}},"required":["data","has_more","next_cursor"],"type":"object"},"OrderMode":{"description":"`test`: orders are checked and recorded with the request that would be sent, and nothing is sent. `live`: orders are sent. `off`: refused.","enum":["off","test","live"],"type":"string"},"PlaceOrderRequest":{"properties":{"contact_email":{"description":"Where the supplier sends its confirmation.","type":["string","null"]},"contact_name":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"description":"Who at the business placed the order. Ralawise needs one.","example":"Jo Smith"},"contact_phone":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"example":"07712 345678"},"delivery":{"anyOf":[{"$ref":"#/components/schemas/OrderDelivery"},{"type":"null"}],"description":"Where to deliver. Leave out for the supplier's default address for the account (Uneek). Ralawise needs one on every order."},"lines":{"items":{"properties":{"allow_backorder":{"description":"Let the supplier back-order what it cannot ship now (default false).","type":"boolean"},"line_ref":{"description":"Your line reference (default: the line number). Ralawise: up to 15 characters.","maxLength":60,"type":"string"},"quantity":{"maximum":100000,"minimum":1,"type":"integer"},"supplier_sku":{"description":"The supplier's own code; sent as given. Takes precedence over the variant's SKU.","type":"string"},"supplier_variant_id":{"description":"A variant of this supplier; its supplier SKU is sent.","type":"string"}},"required":["quantity"],"type":"object"},"maxItems":500,"minItems":1,"type":"array"},"notes":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}]},"reference":{"description":"Your purchase order number, up to 35 characters (Ralawise: 20). One live order per reference.","example":"PO-10442","maxLength":35,"type":"string"},"special_instructions":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}]},"supplier_id":{"description":"Supplier ID or slug.","type":"string"}},"required":["supplier_id","reference","lines"],"type":"object"},"Plan":{"additionalProperties":false,"properties":{"api_requests_per_month":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}],"description":"Null: unlimited."},"code":{"type":"string"},"description":{"type":["string","null"]},"free_access":{"description":"true: the partner's own free plan, for tenants it gives free access. Not for sale: use `free_access: true`, not this plan's code.","type":"boolean"},"id":{"type":"string"},"linked_variants_included":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}],"description":"Null: unlimited."},"name":{"type":"string"},"price":{"anyOf":[{"additionalProperties":false,"properties":{"amount_minor":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"currency":{"type":"string"},"interval":{"const":"month","type":"string"},"tax":{"const":"exclusive","type":"string"}},"required":["amount_minor","currency","interval","tax"],"type":"object"},{"type":"null"}],"description":"Excluding VAT."},"sync_interval_minutes":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"trial_days":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["id","code","name","description","price","linked_variants_included","api_requests_per_month","sync_interval_minutes","trial_days","free_access"],"type":"object"},"PlanList":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/Plan"},"type":"array"}},"required":["data"],"type":"object"},"Problem":{"additionalProperties":false,"description":"RFC 9457 problem details.","properties":{"code":{"description":"Stable machine-readable error code.","example":"insufficient_scope","type":"string"},"detail":{"type":"string"},"errors":{"items":{"additionalProperties":false,"properties":{"message":{"type":"string"},"path":{"type":"string"}},"required":["path","message"],"type":"object"},"type":"array"},"request_id":{"type":"string"},"status":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"title":{"type":"string"},"type":{"example":"https://api.suppliers.noviadigital.io/problems/insufficient_scope","type":"string"}},"required":["type","title","status","code","request_id"],"type":"object"},"Product":{"additionalProperties":false,"properties":{"brand":{"type":["string","null"]},"category":{"type":["string","null"]},"id":{"type":"string"},"image_url":{"type":["string","null"]},"manufacturer_code":{"description":"The manufacturer's style code.","type":["string","null"]},"name":{"type":"string"},"product_code":{"type":"string"},"status":{"enum":["active","discontinued"],"type":"string"},"supplier":{"$ref":"#/components/schemas/SupplierRef"},"updated_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"variant_count":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"variants":{"items":{"$ref":"#/components/schemas/Variant"},"type":"array"}},"required":["id","supplier","product_code","name","brand","manufacturer_code","category","image_url","status","variant_count","updated_at","variants"],"type":"object"},"ProductAvailabilityGrid":{"additionalProperties":false,"properties":{"as_of":{"anyOf":[{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},{"type":"null"}]},"cells":{"items":{"additionalProperties":false,"properties":{"as_of":{"description":"The older of the supplier's timestamp and the load time across the locations used.","example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"available":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}],"description":"Null when the supplier gives a band, or quantities are withheld."},"band":{"description":"The supplier's band text, when banded.","type":["string","null"]},"colour":{"type":["string","null"]},"colour_code":{"type":["string","null"]},"lead_time_days":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]},"locations":{"description":"With `include: [\"locations\"]`.","items":{"$ref":"#/components/schemas/LocationAvailability"},"type":"array"},"next_incoming":{"anyOf":[{"$ref":"#/components/schemas/Incoming"},{"type":"null"}]},"options":{"additionalProperties":{"type":"string"},"propertyNames":{"type":"string"},"type":"object"},"product_code":{"type":"string"},"product_id":{"type":"string"},"quantity_at_least":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}],"description":"Lower bound when stock is banded (\"50+\")."},"size":{"type":["string","null"]},"size_code":{"type":["string","null"]},"stale":{"type":"boolean"},"status":{"$ref":"#/components/schemas/StockStatus"},"supplier":{"$ref":"#/components/schemas/SupplierRef"},"supplier_sku":{"type":"string"},"variant_id":{"type":"string"}},"required":["variant_id","supplier","supplier_sku","product_id","product_code","colour","size","status","available","quantity_at_least","band","next_incoming","lead_time_days","as_of","stale","colour_code","size_code","options"],"type":"object"},"type":"array"},"colours":{"items":{"additionalProperties":false,"properties":{"colour":{"type":["string","null"]},"colour_code":{"type":["string","null"]},"total":{"$ref":"#/components/schemas/StockTotal"}},"required":["colour","colour_code","total"],"type":"object"},"type":"array"},"product":{"additionalProperties":false,"properties":{"brand":{"type":["string","null"]},"id":{"type":"string"},"name":{"type":"string"},"product_code":{"type":"string"},"supplier":{"$ref":"#/components/schemas/SupplierRef"}},"required":["id","product_code","name","brand","supplier"],"type":"object"},"sizes":{"items":{"additionalProperties":false,"properties":{"size":{"type":["string","null"]},"size_code":{"type":["string","null"]},"total":{"$ref":"#/components/schemas/StockTotal"}},"required":["size","size_code","total"],"type":"object"},"type":"array"},"stale":{"type":"boolean"},"total":{"$ref":"#/components/schemas/StockTotal"}},"required":["product","colours","sizes","total","cells","as_of","stale"],"type":"object"},"ProductList":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/ProductSummary"},"type":"array"},"has_more":{"type":"boolean"},"next_cursor":{"description":"Pass as `starting_after` for the next page.","type":["string","null"]}},"required":["data","has_more","next_cursor"],"type":"object"},"ProductSummary":{"additionalProperties":false,"properties":{"brand":{"type":["string","null"]},"category":{"type":["string","null"]},"id":{"type":"string"},"image_url":{"type":["string","null"]},"manufacturer_code":{"description":"The manufacturer's style code.","type":["string","null"]},"name":{"type":"string"},"product_code":{"type":"string"},"status":{"enum":["active","discontinued"],"type":"string"},"supplier":{"$ref":"#/components/schemas/SupplierRef"},"updated_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"variant_count":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["id","supplier","product_code","name","brand","manufacturer_code","category","image_url","status","variant_count","updated_at"],"type":"object"},"QuantityCheckLine":{"anyOf":[{"$ref":"#/components/schemas/ByVariantIdLine"},{"$ref":"#/components/schemas/BySupplierSkuLine"},{"$ref":"#/components/schemas/ByGtinLine"},{"$ref":"#/components/schemas/ByExternalRefLine"}],"description":"One identifier and the quantity needed."},"QuantityCheckRequest":{"properties":{"lines":{"items":{"$ref":"#/components/schemas/QuantityCheckLine"},"maxItems":500,"minItems":1,"type":"array"},"location":{"maxLength":20,"minLength":1,"type":"string"}},"required":["lines"],"type":"object"},"QuantityCheckResponse":{"additionalProperties":false,"properties":{"can_fulfil_now":{"type":"boolean"},"fulfil_by":{"anyOf":[{"example":"2026-11-21","format":"date","type":"string"},{"type":"null"}],"description":"The date by which every line can be met, or null."},"lines":{"items":{"additionalProperties":false,"properties":{"allocation":{"additionalProperties":false,"properties":{"incoming":{"items":{"additionalProperties":false,"properties":{"expected_on":{"example":"2026-11-21","format":"date","type":"string"},"location":{"type":"string"},"quantity":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["location","quantity","expected_on"],"type":"object"},"type":"array"},"now":{"items":{"additionalProperties":false,"properties":{"location":{"type":"string"},"quantity":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["location","quantity"],"type":"object"},"type":"array"}},"required":["now","incoming"],"type":"object"},"as_of":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"available_now":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]},"can_fulfil_now":{"type":"boolean"},"candidates":{"description":"Supplier variants the identifier matched; the best is used.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"external_ref":{"type":["string","null"]},"fulfil_by":{"anyOf":[{"example":"2026-11-21","format":"date","type":"string"},{"type":"null"}],"description":"Today if met now; else the date incoming stock completes the line; null if it cannot."},"quantity":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"request_index":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"shortfall":{"description":"Units not available now.","maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"stale":{"type":"boolean"},"status":{"$ref":"#/components/schemas/StockStatus"},"variant_id":{"type":"string"}},"required":["request_index","variant_id","external_ref","quantity","status","stale","as_of","available_now","can_fulfil_now","shortfall","fulfil_by","allocation","candidates"],"type":"object"},"type":"array"},"not_found":{"items":{"additionalProperties":{},"propertyNames":{"type":"string"},"type":"object"},"type":"array"}},"required":["lines","not_found","can_fulfil_now","fulfil_by"],"type":"object"},"StockChanges":{"additionalProperties":false,"properties":{"data":{"items":{"additionalProperties":false,"properties":{"changed_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"cursor":{"type":"string"},"external_ref":{"type":"string"},"new":{"additionalProperties":false,"properties":{"available":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]},"quantity_at_least":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]},"status":{"type":["string","null"]}},"required":["status","available","quantity_at_least"],"type":"object"},"old":{"additionalProperties":false,"properties":{"available":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]},"quantity_at_least":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]},"status":{"type":["string","null"]}},"required":["status","available","quantity_at_least"],"type":"object"},"run_id":{"type":"string"},"supplier_id":{"type":"string"},"variant_id":{"type":"string"}},"required":["cursor","external_ref","variant_id","supplier_id","run_id","changed_at","old","new"],"type":"object"},"type":"array"},"has_more":{"type":"boolean"},"next_cursor":{"description":"Store it and poll from it next time.","type":"string"}},"required":["data","has_more","next_cursor"],"type":"object"},"StockStatus":{"description":"`in_stock` at or above the low-stock threshold; `low_stock` above 0 and below it; `out_of_stock` 0 with nothing incoming; `backorder` 0 with incoming stock dated; `discontinued` ended by the supplier or feed; `unknown` no stock yet or data past the supplier's stale-after age (last numbers still returned, `stale: true`); `supplier_archived` the supplier left the directory; `trade_account_required` the supplier shows stock only to businesses with a trade account number recorded for it.","enum":["in_stock","low_stock","out_of_stock","backorder","discontinued","unknown","supplier_archived","trade_account_required"],"type":"string"},"StockTotal":{"additionalProperties":false,"properties":{"available":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]},"quantity_at_least":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]}},"required":["available","quantity_at_least"],"type":"object"},"Supplier":{"additionalProperties":false,"properties":{"account_opening_url":{"description":"Where a business applies for a trade account.","type":["string","null"]},"api_credential_fields":{"description":"The API login to ask the business for when it connects this supplier (sent as `api_credentials`). Empty: no login needed.","items":{"$ref":"#/components/schemas/CredentialField"},"type":"array"},"api_features":{"description":"What the supplier's API offers with the account's own login (ADR-011). Empty: stock from feeds only.","items":{"$ref":"#/components/schemas/ApiFeature"},"type":"array"},"country":{"type":"string"},"currency":{"type":"string"},"default_lead_time_days":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]},"id":{"type":"string"},"last_sync_at":{"anyOf":[{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},{"type":"null"}]},"locations":{"items":{"$ref":"#/components/schemas/Location"},"type":"array"},"logo_url":{"type":["string","null"]},"low_stock_threshold":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"name":{"type":"string"},"needs_trade_account":{"description":"Stock is shown only to accounts that recorded a trade account number with this supplier.","type":"boolean"},"slug":{"type":"string"},"stale":{"description":"No successful import within the stale-after age.","type":"boolean"},"stale_after_hours":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"status":{"description":"Paused suppliers keep their data but stop syncing.","enum":["active","paused"],"type":"string"},"website":{"type":["string","null"]}},"required":["id","slug","name","status","website","logo_url","account_opening_url","needs_trade_account","country","currency","low_stock_threshold","stale_after_hours","default_lead_time_days","last_sync_at","stale","locations","api_features","api_credential_fields"],"type":"object"},"SupplierConnection":{"additionalProperties":false,"properties":{"created_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"credentials":{"additionalProperties":{"type":"string"},"description":"Hints only: logins as entered, secrets as their last four characters.","example":{"password":"…x9Qa","username":"buyer@example.com"},"propertyNames":{"type":"string"},"type":"object"},"features":{"items":{"$ref":"#/components/schemas/ApiFeature"},"type":"array"},"last_checked_at":{"anyOf":[{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},{"type":"null"}]},"last_error":{"type":["string","null"]},"order_mode":{"$ref":"#/components/schemas/OrderMode"},"status":{"description":"`verified`: the supplier accepted the login at the last check or call. `failed`: it refused it. `unverified`: not checked yet, or the supplier was unreachable.","enum":["unverified","verified","failed"],"type":"string"},"supplier_id":{"type":"string"},"updated_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"}},"required":["supplier_id","status","credentials","last_checked_at","last_error","features","order_mode","created_at","updated_at"],"type":"object"},"SupplierConnectionPutRequest":{"properties":{"credentials":{"additionalProperties":{"type":"string"},"description":"The business's own API login at the supplier, with the fields the supplier's `api_credential_fields` lists. Uneek Clothing and Ralawise: `username` and `password`. PenCarrie: `customer_code`. Absolute Apparel: `api_key`.","example":{"password":"secret","username":"buyer@example.com"},"propertyNames":{"type":"string"},"type":"object"}},"required":["credentials"],"type":"object"},"SupplierInvoice":{"additionalProperties":false,"properties":{"due_on":{"anyOf":[{"example":"2026-11-21","format":"date","type":"string"},{"type":"null"}]},"invoice_number":{"type":["string","null"]},"invoiced_at":{"anyOf":[{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},{"type":"null"}]},"lines":{"items":{"additionalProperties":false,"properties":{"amount":{"type":["number","null"]},"description":{"type":["string","null"]},"quantity":{"type":["number","null"]},"sku":{"type":["string","null"]},"unit_price":{"type":["number","null"]}},"required":["sku","description","quantity","unit_price","amount"],"type":"object"},"type":"array"},"net":{"anyOf":[{"$ref":"#/components/schemas/SupplierMoney"},{"type":"null"}]},"order_number":{"type":["string","null"]},"outstanding":{"anyOf":[{"$ref":"#/components/schemas/SupplierMoney"},{"type":"null"}]},"reference":{"type":["string","null"]},"supplier_data":{"additionalProperties":{},"description":"The supplier's record as it came, for fields not mapped above.","propertyNames":{"type":"string"},"type":"object"},"tax":{"anyOf":[{"$ref":"#/components/schemas/SupplierMoney"},{"type":"null"}]},"total":{"anyOf":[{"$ref":"#/components/schemas/SupplierMoney"},{"type":"null"}]}},"required":["invoice_number","order_number","reference","invoiced_at","due_on","net","tax","total","outstanding","lines","supplier_data"],"type":"object"},"SupplierInvoiceList":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/SupplierInvoice"},"type":"array"},"fetched_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"has_more":{"description":"More matched than `limit`; narrow the filters.","type":"boolean"}},"required":["data","has_more","fetched_at"],"type":"object"},"SupplierList":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/Supplier"},"type":"array"},"has_more":{"type":"boolean"},"next_cursor":{"description":"Pass as `starting_after` for the next page.","type":["string","null"]}},"required":["data","has_more","next_cursor"],"type":"object"},"SupplierMoney":{"additionalProperties":false,"properties":{"amount":{"type":"number"},"currency":{"type":["string","null"]}},"required":["amount","currency"],"type":"object"},"SupplierOrder":{"additionalProperties":false,"description":"An order as the supplier reports it. Fields it does not give are null or empty.","properties":{"invoice_numbers":{"items":{"type":"string"},"type":"array"},"lines":{"items":{"additionalProperties":false,"properties":{"description":{"type":["string","null"]},"quantity":{"type":["number","null"]},"quantity_shipped":{"type":["number","null"]},"sku":{"type":["string","null"]},"unit_price":{"type":["number","null"]}},"required":["sku","description","quantity","quantity_shipped","unit_price"],"type":"object"},"type":"array"},"order_number":{"type":["string","null"]},"ordered_at":{"anyOf":[{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},{"type":"null"}]},"reference":{"type":["string","null"]},"shipment_numbers":{"items":{"type":"string"},"type":"array"},"status":{"description":"The supplier's own status words.","type":["string","null"]},"supplier_data":{"additionalProperties":{},"description":"The supplier's record as it came, for fields not mapped above.","propertyNames":{"type":"string"},"type":"object"},"total":{"anyOf":[{"$ref":"#/components/schemas/SupplierMoney"},{"type":"null"}]},"tracking_numbers":{"items":{"type":"string"},"type":"array"}},"required":["order_number","reference","status","ordered_at","invoice_numbers","shipment_numbers","tracking_numbers","total","lines","supplier_data"],"type":"object"},"SupplierOrderList":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/SupplierOrder"},"type":"array"},"fetched_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"has_more":{"description":"More matched than `limit`; narrow the filters.","type":"boolean"}},"required":["data","has_more","fetched_at"],"type":"object"},"SupplierRef":{"additionalProperties":false,"properties":{"id":{"example":"sup_01jd7p…","type":"string"},"slug":{"example":"example-wholesale","type":"string"}},"required":["id","slug"],"type":"object"},"SupplierStock":{"additionalProperties":false,"properties":{"available":{"type":["number","null"]},"colour":{"type":["string","null"]},"description":{"type":["string","null"]},"incoming":{"items":{"additionalProperties":false,"properties":{"expected_on":{"anyOf":[{"example":"2026-11-21","format":"date","type":"string"},{"type":"null"}]},"quantity":{"type":"number"}},"required":["quantity","expected_on"],"type":"object"},"type":"array"},"product_code":{"type":["string","null"]},"size":{"type":["string","null"]},"sku":{"type":["string","null"]},"supplier_data":{"additionalProperties":{},"description":"The supplier's record as it came, for fields not mapped above.","propertyNames":{"type":"string"},"type":"object"},"supplier_variant_id":{"description":"Our variant with this SKU, if the catalogue has it.","type":["string","null"]}},"required":["sku","supplier_variant_id","product_code","description","colour","size","available","incoming","supplier_data"],"type":"object"},"SupplierStockList":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/SupplierStock"},"type":"array"},"fetched_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"}},"required":["data","fetched_at"],"type":"object"},"TokenResponse":{"additionalProperties":false,"properties":{"access_token":{"type":"string"},"expires_in":{"example":900,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"sandbox":{"const":true,"description":"Only present, and true, for a sandbox account: its orders are only ever recorded as tests (see Sandbox accounts in the docs).","type":"boolean"},"scope":{"example":"catalogue:read stock:read links:write","type":"string"},"token_type":{"const":"Bearer","type":"string"}},"required":["access_token","token_type","expires_in","scope"],"type":"object"},"Usage":{"additionalProperties":false,"properties":{"allowances":{"additionalProperties":false,"description":"Null: unlimited.","properties":{"api_requests_per_month":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]},"linked_variants":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]},"sync_interval_minutes":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["linked_variants","api_requests_per_month","sync_interval_minutes"],"type":"object"},"daily":{"items":{"additionalProperties":false,"properties":{"api_requests":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"date":{"example":"2026-11-21","format":"date","type":"string"},"linked_variants_peak":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["date","api_requests","linked_variants_peak"],"type":"object"},"type":"array"},"period":{"additionalProperties":false,"properties":{"end":{"example":"2026-11-21","format":"date","type":"string"},"start":{"example":"2026-11-21","format":"date","type":"string"}},"required":["start","end"],"type":"object"},"totals":{"additionalProperties":false,"properties":{"api_requests":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"linked_variants":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"linked_variants_peak":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"}},"required":["api_requests","linked_variants","linked_variants_peak"],"type":"object"}},"required":["period","allowances","totals","daily"],"type":"object"},"Variant":{"additionalProperties":false,"properties":{"colour":{"type":["string","null"]},"colour_code":{"type":["string","null"]},"gtin":{"type":["string","null"]},"id":{"type":"string"},"in_feed":{"description":"False when the last full catalogue load did not include it.","type":"boolean"},"lead_time_days":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]},"list_price":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"manufacturer_sku":{"type":["string","null"]},"options":{"additionalProperties":{"type":"string"},"propertyNames":{"type":"string"},"type":"object"},"pack_size":{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},"product_code":{"type":"string"},"product_id":{"type":"string"},"size":{"type":["string","null"]},"size_code":{"type":["string","null"]},"status":{"enum":["active","discontinued"],"type":"string"},"supplier":{"$ref":"#/components/schemas/SupplierRef"},"supplier_sku":{"type":"string"},"updated_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"}},"required":["id","product_id","supplier","supplier_sku","product_code","colour","colour_code","size","size_code","gtin","manufacturer_sku","options","pack_size","list_price","lead_time_days","status","in_feed","updated_at"],"type":"object"},"VariantIdentifier":{"anyOf":[{"$ref":"#/components/schemas/ByVariantId"},{"$ref":"#/components/schemas/BySupplierSku"},{"$ref":"#/components/schemas/ByGtin"},{"$ref":"#/components/schemas/ByExternalRef"}]},"VariantList":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/Variant"},"type":"array"},"has_more":{"type":"boolean"},"next_cursor":{"description":"Pass as `starting_after` for the next page.","type":["string","null"]}},"required":["data","has_more","next_cursor"],"type":"object"},"WebhookEndpoint":{"additionalProperties":false,"properties":{"created_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"description":{"type":["string","null"]},"disabled_reason":{"type":["string","null"]},"event_types":{"items":{"$ref":"#/components/schemas/EventType"},"type":"array"},"failing_since":{"anyOf":[{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},{"type":"null"}]},"id":{"example":"whe_01jd…","type":"string"},"previous_secret_expires_at":{"anyOf":[{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},{"type":"null"}],"description":"During a rotation, the old secret still verifies until this time."},"secret":{"description":"Standard Webhooks secret (`whsec_…`). Returned once, on create and rotate.","type":"string"},"status":{"enum":["enabled","disabled"],"type":"string"},"updated_at":{"example":"2026-11-09T08:00:00Z","format":"date-time","type":"string"},"url":{"format":"uri","type":"string"}},"required":["id","url","description","event_types","status","disabled_reason","failing_since","previous_secret_expires_at","created_at","updated_at"],"type":"object"},"WebhookEndpointCreate":{"properties":{"description":{"type":["string","null"]},"event_types":{"description":"Default: every type this client can receive.","items":{"$ref":"#/components/schemas/EventType"},"type":"array"},"url":{"description":"HTTPS, resolving to a public address.","format":"uri","type":"string"}},"required":["url"],"type":"object"},"WebhookEndpointList":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/WebhookEndpoint"},"type":"array"}},"required":["data"],"type":"object"},"WebhookEndpointPatch":{"properties":{"description":{"type":["string","null"]},"event_types":{"items":{"$ref":"#/components/schemas/EventType"},"type":"array"},"status":{"description":"Re-enable an endpoint that was disabled after failing.","enum":["enabled","disabled"],"type":"string"},"url":{"type":"string"}},"type":"object"},"WebhookTestResult":{"additionalProperties":false,"properties":{"error":{"type":["string","null"]},"event_id":{"type":"string"},"response_ms":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]},"response_status":{"anyOf":[{"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer"},{"type":"null"}]},"status":{"enum":["succeeded","failed","skipped"],"type":"string"}},"required":["event_id","status","response_status","response_ms","error"],"type":"object"}},"securitySchemes":{"clientBasic":{"description":"Client ID and secret, for the /oauth endpoints.","scheme":"basic","type":"http"},"oauth2":{"description":"Access tokens from POST /oauth/token, valid for 15 minutes.","flows":{"clientCredentials":{"scopes":{"accounts:read":"Partner: read accounts, plans and usage.","accounts:write":"Partner: create, update, suspend and cancel accounts; issue and revoke account credentials; open billing pages.","catalogue:read":"Account: suppliers, products and variants.","inventory:write":"Supplier (phase 2): push stock for one supplier.","links:read":"Account: read links.","links:write":"Account: create, change and remove links; ask for match suggestions.","orders:read":"Account: orders placed here, and the supplier's own order history, invoices and live stock.","orders:write":"Account: place orders with suppliers and manage the account's supplier API connections.","stock:read":"Account: availability, quantity checks and the changes feed.","usage:read":"Account: the account's own usage.","webhooks:write":"Account or partner: manage webhook endpoints and resend deliveries."},"tokenUrl":"https://suppliers.presslane.ai/oauth/token"}},"type":"oauth2"}}},"info":{"contact":{"name":"Novia Digital","url":"https://noviadigital.io"},"description":"Wholesale suppliers' stock for the Novia platform and other partners. JSON over HTTPS, OAuth2 client credentials, cursor pagination (`limit`, `starting_after`), RFC 9457 errors with a stable `code`, `Idempotency-Key` on POST and PUT, ETags on GET. `/v1` changes only by adding fields, endpoints or enum values: ignore what you do not know. Sandbox accounts, for trying the API, read the real catalogue and stock but never have their orders sent to a supplier; their token answer has `sandbox: true` and every answer to them carries the header `Sandbox: true`.","title":"Presslane Suppliers API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/oauth/introspect":{"post":{"description":"A client may introspect its own tokens; a partner those of its accounts' clients. Anything else is `active: false`.","operationId":"introspectToken","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"properties":{"client_id":{"description":"With `client_secret_post`; otherwise use HTTP Basic.","type":"string"},"client_secret":{"type":"string"},"token":{"type":"string"},"token_type_hint":{"type":"string"}},"required":["token"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntrospectionResponse"}}},"description":"Token state."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthError"}}},"description":"Bad request, unsupported grant or scope."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthError"}}},"description":"Client authentication failed (`invalid_client`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthError"}}},"description":"Too many token requests.","headers":{"Retry-After":{"required":true,"schema":{"type":"string"}}}}},"security":[{"clientBasic":[]},{}],"summary":"Introspect a token (RFC 7662)","tags":["OAuth2"]}},"/oauth/revoke":{"post":{"description":"Always 200 for an authenticated caller, whether or not the token was valid.","operationId":"revokeToken","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"properties":{"client_id":{"description":"With `client_secret_post`; otherwise use HTTP Basic.","type":"string"},"client_secret":{"type":"string"},"token":{"type":"string"},"token_type_hint":{"type":"string"}},"required":["token"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Revoked (or nothing to do)."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthError"}}},"description":"Bad request, unsupported grant or scope."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthError"}}},"description":"Client authentication failed (`invalid_client`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthError"}}},"description":"Too many token requests.","headers":{"Retry-After":{"required":true,"schema":{"type":"string"}}}}},"security":[{"clientBasic":[]},{}],"summary":"Revoke a token (RFC 7009)","tags":["OAuth2"]}},"/oauth/token":{"post":{"description":"Authenticate with HTTP Basic (`client_secret_basic`) or `client_id` and `client_secret` in the body (`client_secret_post`). The token is a JWT valid for 15 minutes; there is no refresh token, ask again.","operationId":"getToken","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"properties":{"client_id":{"description":"With `client_secret_post`; otherwise use HTTP Basic.","type":"string"},"client_secret":{"type":"string"},"grant_type":{"const":"client_credentials","type":"string"},"scope":{"description":"Space-separated; up to those granted. One of: accounts:write, accounts:read, catalogue:read, stock:read, links:write, links:read, webhooks:write, usage:read, inventory:write, orders:write, orders:read.","type":"string"}},"required":["grant_type"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenResponse"}}},"description":"A token."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthError"}}},"description":"Bad request, unsupported grant or scope."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthError"}}},"description":"Client authentication failed (`invalid_client`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}}}},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthError"}}},"description":"Too many token requests.","headers":{"Retry-After":{"required":true,"schema":{"type":"string"}}}}},"security":[{"clientBasic":[]},{}],"summary":"Get an access token (client credentials)","tags":["OAuth2"]}},"/v1/account/suppliers":{"get":{"description":"With the trade account number at each. Matching searches these by default.","operationId":"listAccountSuppliers","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSupplierList"}}},"description":"The list.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["catalogue:read"]}],"summary":"The suppliers the account uses","tags":["Links"]},"put":{"description":"Entries may carry the business’s API login at suppliers that offer one (`api_credentials`). All logins are checked with their suppliers first; if any is refused, nothing changes (409 `supplier_auth_failed`, with the entry in `errors`).","operationId":"putAccountSuppliers","parameters":[{"description":"A repeat within 24 hours returns the first response.","in":"header","name":"Idempotency-Key","schema":{"description":"A repeat within 24 hours returns the first response.","maxLength":255,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSuppliersPutRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSupplierList"}}},"description":"The list after the change.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["links:write"]}],"summary":"Replace the suppliers the account uses","tags":["Links"]}},"/v1/account/suppliers/{supplier_id}":{"delete":{"operationId":"removeAccountSupplier","parameters":[{"in":"path","name":"supplier_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Removed.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["links:write"]}],"summary":"Remove a supplier from the account’s list","tags":["Links"]},"get":{"operationId":"getAccountSupplier","parameters":[{"description":"Supplier ID or slug.","in":"path","name":"supplier_id","required":true,"schema":{"description":"Supplier ID or slug.","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSupplier"}}},"description":"The supplier, with the state of the account’s API login there.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["catalogue:read"]}],"summary":"One supplier the account uses","tags":["Links"]},"put":{"description":"Adds the supplier to the account’s list, or updates it. Where the supplier offers API access (its `api_credential_fields` are not empty), send the business’s own API login there as `api_credentials`: it is checked with a harmless read at the supplier, then stored encrypted and used for every later call to that supplier for this account (orders, invoices, live stock). A login the supplier refuses changes nothing (409 `supplier_auth_failed`). Without a login the supplier is still connected for stock, and `api.needs_credentials` stays true.","operationId":"connectAccountSupplier","parameters":[{"description":"Supplier ID or slug.","in":"path","name":"supplier_id","required":true,"schema":{"description":"Supplier ID or slug.","type":"string"}},{"description":"A repeat within 24 hours returns the first response.","in":"header","name":"Idempotency-Key","schema":{"description":"A repeat within 24 hours returns the first response.","maxLength":255,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSupplierPutRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSupplier"}}},"description":"The supplier as connected.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"409":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Conflict, including a reused `Idempotency-Key` (`idempotency_conflict`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"502":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The supplier's API did not answer (`supplier_unavailable`) or answered with an error (`supplier_error`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["links:write"]}],"summary":"Connect a supplier to the account","tags":["Links"]}},"/v1/account/suppliers/{supplier_id}/connection":{"delete":{"operationId":"deleteSupplierConnection","parameters":[{"description":"Supplier ID or slug.","in":"path","name":"supplier_id","required":true,"schema":{"description":"Supplier ID or slug.","type":"string"}}],"responses":{"204":{"description":"Removed.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["orders:write"]}],"summary":"Remove the stored login","tags":["Ordering"]},"get":{"description":"Status and hints only; credentials are never returned.","operationId":"getSupplierConnection","parameters":[{"description":"Supplier ID or slug.","in":"path","name":"supplier_id","required":true,"schema":{"description":"Supplier ID or slug.","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierConnection"}}},"description":"The connection.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["orders:read"]}],"summary":"The account's connection to a supplier's API","tags":["Ordering"]},"put":{"description":"Only suppliers with an API in Presslane Suppliers (see `api_features` on the supplier) can be connected; others answer 409 `supplier_feature_unavailable`. The supplier must be in the account’s list (PUT /v1/account/suppliers). The login is checked with a harmless read first: one the supplier refuses is not saved (409 `supplier_auth_failed`); if the supplier cannot be reached it is saved as `unverified`. Stored encrypted; replaces any earlier login.","operationId":"putSupplierConnection","parameters":[{"description":"Supplier ID or slug.","in":"path","name":"supplier_id","required":true,"schema":{"description":"Supplier ID or slug.","type":"string"}},{"description":"A repeat within 24 hours returns the first response.","in":"header","name":"Idempotency-Key","schema":{"description":"A repeat within 24 hours returns the first response.","maxLength":255,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierConnectionPutRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierConnection"}}},"description":"The connection after the change.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"409":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Conflict, including a reused `Idempotency-Key` (`idempotency_conflict`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"502":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The supplier's API did not answer (`supplier_unavailable`) or answered with an error (`supplier_error`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["orders:write"]}],"summary":"Connect the business's own login at a supplier","tags":["Ordering"]}},"/v1/account/suppliers/{supplier_id}/connection/check":{"post":{"operationId":"checkSupplierConnection","parameters":[{"description":"Supplier ID or slug.","in":"path","name":"supplier_id","required":true,"schema":{"description":"Supplier ID or slug.","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierConnection"}}},"description":"The connection with the new status.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"409":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Conflict, including a reused `Idempotency-Key` (`idempotency_conflict`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"502":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The supplier's API did not answer (`supplier_unavailable`) or answered with an error (`supplier_error`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["orders:write"]}],"summary":"Check the stored login again","tags":["Ordering"]}},"/v1/account/suppliers/{supplier_id}/invoices":{"get":{"description":"Straight from the supplier's API with the account's login. Newest first. Without filters, the last 90 days (or from `since`).","operationId":"listSupplierInvoices","parameters":[{"description":"Supplier ID or slug.","in":"path","name":"supplier_id","required":true,"schema":{"description":"Supplier ID or slug.","type":"string"}},{"in":"query","name":"invoice_number","schema":{"type":"string"}},{"description":"The supplier's order number.","in":"query","name":"order_number","schema":{"description":"The supplier's order number.","type":"string"}},{"description":"Your reference (purchase order number).","in":"query","name":"reference","schema":{"description":"Your reference (purchase order number).","type":"string"}},{"description":"Invoices on this day.","in":"query","name":"date","schema":{"description":"Invoices on this day.","example":"2026-11-21","format":"date","type":"string"}},{"description":"Invoices from this day on, when no other filter is given (default 90 days ago).","in":"query","name":"since","schema":{"description":"Invoices from this day on, when no other filter is given (default 90 days ago).","example":"2026-11-21","format":"date","type":"string"}},{"description":"Default 100, newest first.","in":"query","name":"limit","schema":{"description":"Default 100, newest first.","maximum":500,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierInvoiceList"}}},"description":"Invoices.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"409":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Conflict, including a reused `Idempotency-Key` (`idempotency_conflict`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"502":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The supplier's API did not answer (`supplier_unavailable`) or answered with an error (`supplier_error`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["orders:read"]}],"summary":"The account's invoices from the supplier","tags":["Ordering"]}},"/v1/account/suppliers/{supplier_id}/orders":{"get":{"description":"Straight from the supplier's API with the account's login: every order on the account, however it was placed. Newest first. Not stored here; at most 30 supplier calls a minute per account and supplier.","operationId":"listSupplierOrders","parameters":[{"description":"Supplier ID or slug.","in":"path","name":"supplier_id","required":true,"schema":{"description":"Supplier ID or slug.","type":"string"}},{"description":"Your reference (purchase order number).","in":"query","name":"reference","schema":{"description":"Your reference (purchase order number).","type":"string"}},{"in":"query","name":"order_number","schema":{"type":"string"}},{"in":"query","name":"invoice_number","schema":{"type":"string"}},{"in":"query","name":"shipment_number","schema":{"type":"string"}},{"in":"query","name":"tracking_number","schema":{"type":"string"}},{"description":"Orders on this day.","in":"query","name":"date","schema":{"description":"Orders on this day.","example":"2026-11-21","format":"date","type":"string"}},{"description":"Default 100, newest first.","in":"query","name":"limit","schema":{"description":"Default 100, newest first.","maximum":500,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierOrderList"}}},"description":"Orders.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"409":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Conflict, including a reused `Idempotency-Key` (`idempotency_conflict`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"502":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The supplier's API did not answer (`supplier_unavailable`) or answered with an error (`supplier_error`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["orders:read"]}],"summary":"The account's orders at the supplier","tags":["Ordering"]}},"/v1/account/suppliers/{supplier_id}/stock":{"get":{"description":"Asks the supplier's API now, with the account's login, by SKU, variant or style. A variant is looked up by its style and matched like the stock feed (by SKU, else style, colour and size), so each row's `sku` is the supplier's own code even where it differs from the catalogue's: send it as `supplier_sku` to order. For everyday availability use /v1/availability, which is precomputed from the supplier feeds and needs no login; this is for a last check before ordering. Ralawise allows 10 calls a minute per login (each style is one call): ask about at most 7 styles at once, or expect 429 `rate_limited` with `Retry-After`. Absolute Apparel: `available` is the stock available today; what it can get in beyond that is in `incoming`, without a date. Laltex: a made-to-order item has `available: null` (`FreeStock` -1 in `supplier_data`).","operationId":"getSupplierStock","parameters":[{"description":"Supplier ID or slug.","in":"path","name":"supplier_id","required":true,"schema":{"description":"Supplier ID or slug.","type":"string"}},{"description":"The supplier's SKUs (repeat the parameter).","in":"query","name":"sku","schema":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"The supplier's SKUs (repeat the parameter)."}},{"description":"Variant IDs of this supplier (repeat the parameter), from at most 10 styles. The answer keeps their rows, with the supplier’s own code as `sku`.","in":"query","name":"variant","schema":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Variant IDs of this supplier (repeat the parameter), from at most 10 styles. The answer keeps their rows, with the supplier’s own code as `sku`."}},{"description":"A style code (GR11): every row of the style. Otherwise up to 50 SKUs and variants together.","in":"query","name":"product_code","schema":{"description":"A style code (GR11): every row of the style. Otherwise up to 50 SKUs and variants together.","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierStockList"}}},"description":"Stock rows; SKUs the supplier does not know are left out.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"409":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Conflict, including a reused `Idempotency-Key` (`idempotency_conflict`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"502":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The supplier's API did not answer (`supplier_unavailable`) or answered with an error (`supplier_error`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["stock:read"]}],"summary":"Stock straight from the supplier","tags":["Ordering"]}},"/v1/accounts":{"post":{"description":"Partner only. Creates the account as `pending_payment` and returns a Stripe Checkout link. Calling again for the same `external_ref` returns the same account (201 the first time, 200 after), with a fresh link while it is unpaid. The account becomes `active` when Stripe confirms payment, and `account.activated` is sent to the partner. With `free_access: true` (partners Presslane Suppliers set up for it) the account is `active` at once on the partner’s free plan, with no Checkout and no charge; sent for an existing tenant it gives that tenant free access (a subscription it pays is paused).","operationId":"createAccount","parameters":[{"description":"A repeat within 24 hours returns the first response.","in":"header","name":"Idempotency-Key","schema":{"description":"A repeat within 24 hours returns the first response.","maxLength":255,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCreateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCreateResponse"}}},"description":"The existing account for this tenant.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCreateResponse"}}},"description":"Created.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"409":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Conflict, including a reused `Idempotency-Key` (`idempotency_conflict`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["accounts:write"]}],"summary":"Create an account for a tenant","tags":["Accounts"]}},"/v1/accounts/{id}":{"get":{"description":"Status, plan, allowances and usage this period.","operationId":"getAccount","parameters":[{"description":"Account ID (acc_…).","in":"path","name":"id","required":true,"schema":{"description":"Account ID (acc_…).","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Account"}}},"description":"The account.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["accounts:read"]}],"summary":"Get an account","tags":["Accounts"]},"patch":{"description":"Upgrades take effect at once with proration; downgrades at the next period, and only if linked variants fit the lower allowance (403 `allowance_exceeded`). `suspended: true` is the platform lock: the account is suspended at once and billing stops. `free_access` gives or ends free access (403 when the partner has no free plan; 409 to change `plan` while it is on, or on a complimentary account Presslane Suppliers set).","operationId":"updateAccount","parameters":[{"description":"Account ID (acc_…).","in":"path","name":"id","required":true,"schema":{"description":"Account ID (acc_…).","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountPatchRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Account"}}},"description":"The account after the change.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"409":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Conflict, including a reused `Idempotency-Key` (`idempotency_conflict`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["accounts:write"]}],"summary":"Change plan, free access, suspend, resume or cancel at period end","tags":["Accounts"]}},"/v1/accounts/{id}/billing-portal":{"post":{"description":"A short-lived link where the tenant sees invoices and changes the card. The return URL must be allowed for the partner.","operationId":"createBillingPortalLink","parameters":[{"description":"Account ID (acc_…).","in":"path","name":"id","required":true,"schema":{"description":"Account ID (acc_…).","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingPortalRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingPortalResponse"}}},"description":"The portal link.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"409":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Conflict, including a reused `Idempotency-Key` (`idempotency_conflict`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["accounts:write"]}],"summary":"Open the Stripe customer portal","tags":["Accounts"]}},"/v1/accounts/{id}/clients":{"post":{"description":"The secret is returned once. An account can hold several clients; revoke old ones after swapping.","operationId":"createAccountClient","parameters":[{"description":"Account ID (acc_…).","in":"path","name":"id","required":true,"schema":{"description":"Account ID (acc_…).","type":"string"}},{"description":"A repeat within 24 hours returns the first response.","in":"header","name":"Idempotency-Key","schema":{"description":"A repeat within 24 hours returns the first response.","maxLength":255,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientCreateRequest"}}},"required":false},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientCredentials"}}},"description":"The new client, with its secret.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"409":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Conflict, including a reused `Idempotency-Key` (`idempotency_conflict`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["accounts:write"]}],"summary":"Issue account API credentials","tags":["Accounts"]}},"/v1/accounts/{id}/clients/{client_id}":{"delete":{"description":"The client can get no new tokens, and its existing tokens stop working within 60 seconds.","operationId":"revokeAccountClient","parameters":[{"description":"Account ID (acc_…).","in":"path","name":"id","required":true,"schema":{"description":"Account ID (acc_…).","type":"string"}},{"description":"Client ID (cli_…).","in":"path","name":"client_id","required":true,"schema":{"description":"Client ID (cli_…).","type":"string"}}],"responses":{"204":{"description":"Revoked.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["accounts:write"]}],"summary":"Revoke account credentials","tags":["Accounts"]}},"/v1/availability/check":{"post":{"description":"For each line: whether it can be met now, the shortfall, the earliest date incoming stock completes it, and which locations would supply it. Lines for the same variant share its stock. Nothing is reserved; supplier stock can change before you order.","operationId":"checkQuantities","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuantityCheckRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuantityCheckResponse"}}},"description":"The check result.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["stock:read"]}],"summary":"Can these quantities be met, and by when","tags":["Availability"]}},"/v1/availability/lookup":{"post":{"description":"By any mix of variant ID, supplier + SKU, GTIN or your own variant reference (`external_ref`, through your links). Identifiers that match nothing come back in `not_found`; they never fail the request. Reserves nothing.","operationId":"lookupAvailability","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvailabilityLookupRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvailabilityLookupResponse"}}},"description":"Availability per matched variant.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["stock:read"]}],"summary":"Availability for up to 500 variants","tags":["Availability"]}},"/v1/links":{"get":{"operationId":"listLinks","parameters":[{"description":"Page size, 1–200 (default 50).","in":"query","name":"limit","schema":{"default":50,"description":"Page size, 1–200 (default 50).","maximum":200,"minimum":1,"type":"integer"}},{"description":"The `next_cursor` from the previous page.","in":"query","name":"starting_after","schema":{"description":"The `next_cursor` from the previous page.","maxLength":80,"type":"string"}},{"description":"One or more refs (repeat the parameter).","in":"query","name":"external_ref","schema":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"One or more refs (repeat the parameter)."}},{"description":"Only links to this supplier.","in":"query","name":"supplier","schema":{"description":"Only links to this supplier.","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkList"}}},"description":"A page of links.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["links:read"]}],"summary":"List links","tags":["Links"]},"put":{"description":"Keyed by the account’s own variant reference. For each `external_ref` sent, its links become exactly the variants listed. All or nothing. A change that would pass the plan’s linked-variant allowance is refused with 403 `allowance_exceeded`.","operationId":"putLinks","parameters":[{"description":"A repeat within 24 hours returns the first response.","in":"header","name":"Idempotency-Key","schema":{"description":"A repeat within 24 hours returns the first response.","maxLength":255,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinksPutRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinksPutResponse"}}},"description":"The result.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"409":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Conflict, including a reused `Idempotency-Key` (`idempotency_conflict`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["links:write"]}],"summary":"Create or update up to 1,000 links","tags":["Links"]}},"/v1/links/{external_ref}":{"delete":{"operationId":"deleteLinks","parameters":[{"description":"URL-encoded external_ref.","in":"path","name":"external_ref","required":true,"schema":{"description":"URL-encoded external_ref.","type":"string"}}],"responses":{"204":{"description":"Removed.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["links:write"]}],"summary":"Remove the links of one tenant variant","tags":["Links"]}},"/v1/matches":{"post":{"description":"Up to 500 tenant variants. Ranked suggestions: exact GTIN (`gtin`, 1.0); supplier SKU, or style code with colour and size (`strong`, 0.85–0.95); name words with colour and size (`weak`, at most 0.6). Nothing is saved: confirm with PUT /v1/links.","operationId":"suggestMatches","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchResponse"}}},"description":"Suggestions per variant.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["links:write"]}],"summary":"Suggest supplier variants for tenant variants","tags":["Links"]}},"/v1/orders":{"get":{"description":"Newest first.","operationId":"listOrders","parameters":[{"description":"Page size, 1–200 (default 50).","in":"query","name":"limit","schema":{"default":50,"description":"Page size, 1–200 (default 50).","maximum":200,"minimum":1,"type":"integer"}},{"description":"The `next_cursor` from the previous page.","in":"query","name":"starting_after","schema":{"description":"The `next_cursor` from the previous page.","maxLength":80,"type":"string"}},{"in":"query","name":"supplier_id","schema":{"type":"string"}},{"in":"query","name":"status","schema":{"enum":["test","pending","submitted","unconfirmed","failed"],"type":"string"}},{"in":"query","name":"reference","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderList"}}},"description":"A page of orders.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["orders:read"]}],"summary":"Orders placed through Presslane Suppliers","tags":["Ordering"]},"post":{"description":"Sent with the account's own login at the supplier (PUT …/connection first). Each line names a variant of the supplier or the supplier's own SKU. Suppliers whose API takes no orders (Laltex) answer 409 `supplier_feature_unavailable`. While the supplier is in `test` order mode the order is checked and recorded with the exact request that would be sent, and nothing is sent (status `test`). In `live` mode it is sent once and never retried: check `status` in the answer. A second live order with the same reference is refused (409) unless the first one `failed`. Send an `Idempotency-Key` to retry the request safely. Each supplier's own limits are checked first, in test mode too (400 `invalid_request` with `errors`): Ralawise needs `contact_name` and `delivery`, a reference of at most 20 characters and line references of at most 15; PenCarrie takes references of up to 14 letters, digits and underscores, one line per SKU, the same `allow_backorder` on every line, and deliveries in Great Britain; Absolute Apparel takes no `notes` or `special_instructions`, needs the same `allow_backorder` on every line and a delivery code (`delivery.method`, or the default Presslane Suppliers set). What a supplier says about an order it took is in `warnings`.","operationId":"placeOrder","parameters":[{"description":"A repeat within 24 hours returns the first response.","in":"header","name":"Idempotency-Key","schema":{"description":"A repeat within 24 hours returns the first response.","maxLength":255,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaceOrderRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Order"}}},"description":"The order, with its status.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"409":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Conflict, including a reused `Idempotency-Key` (`idempotency_conflict`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"502":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The supplier's API did not answer (`supplier_unavailable`) or answered with an error (`supplier_error`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not available on this deployment right now (`service_unavailable`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["orders:write"]}],"summary":"Place an order with a supplier","tags":["Ordering"]}},"/v1/orders/{id}":{"get":{"description":"With `refresh=true`, a live order is looked up at the supplier by its reference: an `unconfirmed` order found there becomes `submitted`, and `supplier_order` carries the supplier’s view (status, invoices, shipments, tracking). Suppliers whose API has no order history (Ralawise) answer 409 `supplier_feature_unavailable`; check on their website. Absolute Apparel is searched over the last 28 days, as far back as its API looks for a reference.","operationId":"getOrder","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Ask the supplier too (live orders).","in":"query","name":"refresh","schema":{"description":"Ask the supplier too (live orders).","enum":["true","false"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderDetail"}}},"description":"The order.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"409":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Conflict, including a reused `Idempotency-Key` (`idempotency_conflict`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"502":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The supplier's API did not answer (`supplier_unavailable`) or answered with an error (`supplier_error`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["orders:read"]}],"summary":"One order","tags":["Ordering"]}},"/v1/plans":{"get":{"description":"Prices exclude VAT. Allowances are per month; null is unlimited. When Presslane Suppliers set up free access for the partner, its free plan is listed too, with `free_access: true`.","operationId":"listPlans","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanList"}}},"description":"Plans on sale.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["accounts:read"]}],"summary":"List plans on sale","tags":["Accounts"]}},"/v1/products":{"get":{"description":"By supplier, brand, manufacturer style code, text and updated-since.","operationId":"searchProducts","parameters":[{"description":"Page size, 1–200 (default 50).","in":"query","name":"limit","schema":{"default":50,"description":"Page size, 1–200 (default 50).","maximum":200,"minimum":1,"type":"integer"}},{"description":"The `next_cursor` from the previous page.","in":"query","name":"starting_after","schema":{"description":"The `next_cursor` from the previous page.","maxLength":80,"type":"string"}},{"description":"Supplier ID or slug.","in":"query","name":"supplier","schema":{"description":"Supplier ID or slug.","maxLength":100,"type":"string"}},{"in":"query","name":"brand","schema":{"maxLength":100,"type":"string"}},{"in":"query","name":"manufacturer_code","schema":{"maxLength":100,"type":"string"}},{"description":"Words to find in name, brand, product code or style code.","in":"query","name":"q","schema":{"description":"Words to find in name, brand, product code or style code.","maxLength":200,"type":"string"}},{"in":"query","name":"updated_since","schema":{"format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductList"}}},"description":"A page of products.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["catalogue:read"]}],"summary":"Search products","tags":["Catalogue"]}},"/v1/products/{id}":{"get":{"operationId":"getProduct","parameters":[{"in":"path","name":"id","required":true,"schema":{"maxLength":100,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}},"description":"The product and every variant.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["catalogue:read"]}],"summary":"Get a product with its variants","tags":["Catalogue"]}},"/v1/products/{id}/availability":{"get":{"description":"Every variant of the product, with totals per colour, per size and overall.","operationId":"getProductAvailability","parameters":[{"in":"path","name":"id","required":true,"schema":{"maxLength":100,"type":"string"}},{"in":"query","name":"include","schema":{"enum":["locations"],"type":"string"}},{"in":"query","name":"location","schema":{"maxLength":20,"minLength":1,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductAvailabilityGrid"}}},"description":"The grid.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["stock:read"]}],"summary":"Colour by size availability grid","tags":["Availability"]}},"/v1/stock/changes":{"get":{"description":"Up to 500 changes, oldest first, each with your `external_ref`. Start from the `changes_cursor` in a `stock.changed` event or the `next_cursor` of the previous page. More than 30 days behind: 410 `cursor_expired`; re-read all links instead.","operationId":"listStockChanges","parameters":[{"description":"From a stock event or the previous page. Omit to start 30 days back.","in":"query","name":"cursor","schema":{"description":"From a stock event or the previous page. Omit to start 30 days back.","maxLength":40,"type":"string"}},{"in":"query","name":"limit","schema":{"default":500,"maximum":500,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StockChanges"}}},"description":"A page of changes.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"410":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The changes cursor is older than 30 days (`cursor_expired`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["stock:read"]}],"summary":"Changes to linked variants since a cursor","tags":["Availability"]}},"/v1/suppliers":{"get":{"description":"Active and paused suppliers that have completed a first import, with last sync and stale flag.","operationId":"listSuppliers","parameters":[{"description":"Page size, 1–200 (default 50).","in":"query","name":"limit","schema":{"default":50,"description":"Page size, 1–200 (default 50).","maximum":200,"minimum":1,"type":"integer"}},{"description":"The `next_cursor` from the previous page.","in":"query","name":"starting_after","schema":{"description":"The `next_cursor` from the previous page.","maxLength":80,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierList"}}},"description":"A page of suppliers.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["catalogue:read"]}],"summary":"List suppliers","tags":["Catalogue"]}},"/v1/suppliers/{id}":{"get":{"description":"One supplier by ID or slug, with its locations.","operationId":"getSupplier","parameters":[{"description":"Supplier ID or slug.","in":"path","name":"id","required":true,"schema":{"description":"Supplier ID or slug.","maxLength":100,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Supplier"}}},"description":"The supplier.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["catalogue:read"]}],"summary":"Get a supplier","tags":["Catalogue"]}},"/v1/usage":{"get":{"description":"Daily API requests and linked-variant peaks, with the allowances. Works while the account is suspended.","operationId":"getUsage","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Usage"}}},"description":"Usage this period.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["usage:read"]}],"summary":"The account's usage this period","tags":["Usage"]}},"/v1/variants":{"get":{"description":"By supplier and supplier SKU, by GTIN, or by manufacturer SKU.","operationId":"lookupVariants","parameters":[{"description":"Page size, 1–200 (default 50).","in":"query","name":"limit","schema":{"default":50,"description":"Page size, 1–200 (default 50).","maximum":200,"minimum":1,"type":"integer"}},{"description":"The `next_cursor` from the previous page.","in":"query","name":"starting_after","schema":{"description":"The `next_cursor` from the previous page.","maxLength":80,"type":"string"}},{"description":"Supplier ID or slug; needed with supplier_sku.","in":"query","name":"supplier","schema":{"description":"Supplier ID or slug; needed with supplier_sku.","maxLength":100,"type":"string"}},{"in":"query","name":"supplier_sku","schema":{"maxLength":100,"type":"string"}},{"in":"query","name":"gtin","schema":{"pattern":"^\\d{8,14}$","type":"string"}},{"in":"query","name":"manufacturer_sku","schema":{"maxLength":100,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VariantList"}}},"description":"Matching variants.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["catalogue:read"]}],"summary":"Look up variants","tags":["Catalogue"]}},"/v1/webhook-endpoints":{"get":{"description":"The calling account’s endpoints, or the calling partner’s.","operationId":"listWebhookEndpoints","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointList"}}},"description":"Endpoints.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["webhooks:write"]}],"summary":"List webhook endpoints","tags":["Webhooks"]},"post":{"description":"HTTPS, resolving to a public address. The signing secret is returned once. Deliveries are signed the Standard Webhooks way (`webhook-id`, `webhook-timestamp`, `webhook-signature`: HMAC-SHA256 over `id.timestamp.body`). A 2xx within 10 seconds is a success; otherwise retries follow at about 30 s, 2 min, 10 min, 1 h, 6 h and 24 h, then daily. After 3 days of failures the endpoint is disabled. Events can arrive more than once and out of order: ignore an `id` already seen.","operationId":"createWebhookEndpoint","parameters":[{"description":"A repeat within 24 hours returns the first response.","in":"header","name":"Idempotency-Key","schema":{"description":"A repeat within 24 hours returns the first response.","maxLength":255,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointCreate"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"}}},"description":"Created, with its secret.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"409":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Conflict, including a reused `Idempotency-Key` (`idempotency_conflict`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["webhooks:write"]}],"summary":"Create a webhook endpoint","tags":["Webhooks"]}},"/v1/webhook-endpoints/{id}":{"delete":{"operationId":"deleteWebhookEndpoint","parameters":[{"description":"Webhook endpoint ID (whe_…).","in":"path","name":"id","required":true,"schema":{"description":"Webhook endpoint ID (whe_…).","type":"string"}}],"responses":{"204":{"description":"Deleted.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["webhooks:write"]}],"summary":"Delete a webhook endpoint","tags":["Webhooks"]},"get":{"operationId":"getWebhookEndpoint","parameters":[{"description":"Webhook endpoint ID (whe_…).","in":"path","name":"id","required":true,"schema":{"description":"Webhook endpoint ID (whe_…).","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"}}},"description":"The endpoint.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["webhooks:write"]}],"summary":"Get a webhook endpoint","tags":["Webhooks"]},"patch":{"operationId":"updateWebhookEndpoint","parameters":[{"description":"Webhook endpoint ID (whe_…).","in":"path","name":"id","required":true,"schema":{"description":"Webhook endpoint ID (whe_…).","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointPatch"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"}}},"description":"The endpoint.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The request is not valid (`invalid_request`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["webhooks:write"]}],"summary":"Change or re-enable a webhook endpoint","tags":["Webhooks"]}},"/v1/webhook-endpoints/{id}/rotate-secret":{"post":{"description":"The new secret is returned once. For 24 hours deliveries carry signatures from both secrets.","operationId":"rotateWebhookSecret","parameters":[{"description":"Webhook endpoint ID (whe_…).","in":"path","name":"id","required":true,"schema":{"description":"Webhook endpoint ID (whe_…).","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"}}},"description":"The endpoint, with its new secret.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["webhooks:write"]}],"summary":"Rotate the signing secret","tags":["Webhooks"]}},"/v1/webhook-endpoints/{id}/test":{"post":{"description":"A signed `webhook.test` event, sent now; the response says what the receiver answered.","operationId":"testWebhookEndpoint","parameters":[{"description":"Webhook endpoint ID (whe_…).","in":"path","name":"id","required":true,"schema":{"description":"Webhook endpoint ID (whe_…).","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookTestResult"}}},"description":"The attempt.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, expired or revoked token (`invalid_token`).","headers":{"WWW-Authenticate":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"required":true,"schema":{"type":"string"}}}},"403":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The token lacks a scope (`insufficient_scope`), the account is suspended (`account_suspended`), or the client kind cannot call this.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found (`not_found`).","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}},"429":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Too many requests (`rate_limited`); see `Retry-After`.","headers":{"RateLimit-Limit":{"description":"Requests allowed in the current window.","required":true,"schema":{"description":"Requests allowed in the current window.","type":"string"}},"RateLimit-Remaining":{"description":"Requests left in the current window.","required":true,"schema":{"description":"Requests left in the current window.","type":"string"}},"RateLimit-Reset":{"description":"Seconds until the window resets.","required":true,"schema":{"description":"Seconds until the window resets.","type":"string"}},"Retry-After":{"required":true,"schema":{"type":"string"}},"X-Request-Id":{"description":"Request ID, also in logs.","required":true,"schema":{"description":"Request ID, also in logs.","type":"string"}}}}},"security":[{"oauth2":["webhooks:write"]}],"summary":"Send a test event","tags":["Webhooks"]}}},"servers":[{"url":"https://suppliers.presslane.ai"}],"tags":[{"name":"OAuth2"},{"name":"Catalogue"},{"name":"Availability"},{"name":"Accounts"},{"name":"Links"},{"name":"Ordering"},{"name":"Webhooks"},{"name":"Usage"}]}