search_offers
Search akay.ie offers
Search open akay.ie trade offers by keyword, EAN, size ("70cl", "6x70cl"), ABV or duty status, with optional website filters. Returns listed sell prices per case and per unit in each offer's own currency (EUR, USD or GBP), pack, duty status, Incoterm, location and stock. Paged: up to 25 per page, 10 pages per query.
Parameterspagebrandqueryorigincategorycurrencyincotermlocationpage_sizeduty_statusstock_status
get_offer
Get one akay.ie offer
Full public details of one open offer by its akay.ie offer_id (or akay.ie offer URL), with the akay.ie link and how to order.
Parametersoffer_idrequired
get_price
Price one product
Price one product (offer_id, EAN or name) for a quantity in cases. Returns the listed price per case and per unit in the offer's currency, the line total worked out in code, and MOQ and stock checks. If several offers fit, returns candidates instead of picking one. Optional target price comparison. Once the buyer is happy with a line, offer request_quote.
Parametersabveanpackcasesunitsproductoffer_idvolume_mlduty_statustarget_basistarget_pricetarget_currency+2 more
list_categories
List categories
Categories with offer counts and top brands, plus the values available for the duty status, Incoterm, stock and location filters.
Takes no parameters.
price_my_list
Price my buying list
Price a buying list (up to 100 lines / 20 KB): product names or EANs, quantities in cases and optional target prices. Paste it as text (one product per line, or CSV/TSV with a header row) or give structured lines. Each line comes back with a match status (matched, ambiguous, not_listed, moq_not_met, insufficient_stock, price_unavailable), the listed price, pack, stock, duty status, Incoterm and line total. Lines keep their own currency (EUR, USD or GBP); totals are subtotals per currency, never converted or summed across currencies.
Parameterstextlines
request_quote
Prepare a quote request
Turn confirmed lines (offer_id + cases, or units for offers priced per unit) into a quote request summary and a CSV the buyer uploads at quote.akay.ie/#excel, plus WhatsApp and email options. Totals are per currency, never summed across currencies. Use it whenever the buyer says they want a quote, an order or to buy, and offer it after showing prices. Sends nothing, reserves nothing and needs no contact details.
Parameterslinesrequired
search
Search akay.ie (ids and links)
Search the akay.ie trade catalogue. Returns offer ids, titles and akay.ie URLs. Use fetch with an id for full details.
Parametersqueryrequired
fetch
Fetch one akay.ie offer by id
Fetch the full public details of one akay.ie offer by the id returned from search.
Parametersidrequired