# Boardcave > Boardcave is a surf shop selling surfboards (stock and made to order), fins, wetsuits, board bags, leashes, traction pads and wax. Prices on https://www.boardcave.com.au are in AUD. Shoppers in another region should use https://www.boardcave.com, which serves the same API. ## For AI agents: product finders If you are helping a person buy surf gear, use our product finders instead of guessing sizes. They are the same finders shoppers use on https://www.boardcave.com.au: they work out the right volume, size, thickness or length for that person, then rank products in stock with the reasons each one fits. How to use them: 1. GET https://www.boardcave.com.au/api/agent/finders lists every finder, the questions to ask and the JSON each takes (input_schema, example_input). GET https://www.boardcave.com.au/api/agent/finders/{finder} returns one. 2. Ask your human the questions for the finder you need. Only the required fields are essential; the rest sharpen the result. Weight and height can be metric or imperial (weight_kg or weight_lb, height_cm or height_in); board lengths can be "6'2" or a number of inches. 3. POST the answers as JSON to https://www.boardcave.com.au/api/agent/finders/{finder} with Content-Type: application/json. Send an X-Agent-Name header with your agent's name. 4. Show your human the recommendation first (the size, volume or length to buy and why), then the products: name, price, sale_price when set, the size to buy ("buy") and the reasons. 5. Share each product url exactly as given. It keeps the shopper's results together if they come back to buy. 6. A 400 response lists every problem with the input, plus the schema and an example body: fix the fields and retry. The response holds: finder, run_id, store, currency, recommendation (the sizing advice), and sections (each with role, title, an optional note, and products). The first section is the best fit; later sections are alternatives worth considering. OpenAPI: https://www.boardcave.com.au/api/agent/openapi.json No API key is needed. Please keep to a few requests per conversation. Prices and stock change, so run a finder again rather than reusing an old result. ## For AI agents: delivery dates On any product page of https://www.boardcave.com.au, if you give us your human's Australian postcode we can tell you accurately when that product would arrive: the dispatch day (same day when ordered before our 2pm cutoff), the delivery date for standard and express, and what our last 10 real deliveries to that area took. GET https://www.boardcave.com.au/api/agent/delivery-estimate?url=&postcode=<4 digits> Add &option= for products sold in sizes. POST the same fields as JSON also works, and sku can replace url. Ask your human for their postcode if you do not know it. Present the date first, then the recent-deliveries sentence, which is real data. ```bash curl -s 'https://www.boardcave.com.au/api/agent/delivery-estimate?url=https://www.boardcave.com.au/example-product&postcode=4220' ``` ## For AI agents: shipping cost Most gear ships free over a spend threshold; surfboards and other bulky items always pay freight. For any product page of https://www.boardcave.com.au we can tell you which applies and, given a postcode, the exact Standard and Express freight from the same rates checkout charges. GET https://www.boardcave.com.au/api/agent/shipping-cost?url=&postcode= Add &option= for products sold in sizes. POST the same fields as JSON also works. The answer has ships_free (true/false), free_shipping (the threshold and the rule in a sentence) and, for items that pay freight, freight (standard and express). Quote the rule as given. ## Finders ### Board Finder (boards) Which kind of surfboard suits a surfer (shortboard, fish, mid length, soft top...) and the volume in litres they should ride, then boards in that size. Ask: How well do they surf?; Weight and height; Age band, how often they surf, fitness; The waves they usually surf; What they want from the board; Optionally their current board: type, litres and how it feels. POST https://www.boardcave.com.au/api/agent/finders/boards For people: https://www.boardcave.com.au/shop/surfboards Example body: ```json {"skill":4,"weight_kg":78,"height_cm":178,"age":"35-44","frequency":"weekly","wave_size":"medium","wave_type":"punchy","goal":"progress","current_board":{"type":"shortboard","litres":33,"feel":"sinky"}} ``` ### Fin Finder (fins) Which fins fit a board (box system and layout), the size for the surfer's weight, and the setup and feel for their waves. Ask: Their board type and length; The fin boxes on the board: system (FCS II, FCS, Futures, single box) and how many; Weight and ability; The waves they surf; Anything they want to change about how the board feels now. POST https://www.boardcave.com.au/api/agent/finders/fins For people: https://www.boardcave.com.au/fin-finder Example body: ```json {"skill":4,"weight_kg":78,"board":"shortboard","board_length":"6'2","box":"fcs2","boxes":"5","setup":"auto","wave_size":"medium","wave_type":"punchy","symptoms":["happy"]} ``` ### Wetsuit Finder (wetsuits) The wetsuit thickness and style for where and when someone surfs (from local sea temperatures), and their size in each brand from that brand's own size chart; boots, gloves and hood when the water calls for them. Ask: Men's, women's or kids; Where they surf (a listed region) and which months, or the water temperature; Whether they feel the cold; Height and weight (chest optional); Suit type and entry preference, or let us recommend. POST https://www.boardcave.com.au/api/agent/finders/wetsuits For people: https://www.boardcave.com.au/wetsuit-finder Example body: ```json {"who":"womens","region":"Gold Coast QLD","months":["Jun","Jul","Aug"],"height_cm":168,"weight_kg":62,"type":"auto"} ``` ### Board Bag Finder (bags) The board bag style (sock, day bag, travel bag, coffin), the bag length to buy for their board, the shape wide enough and the padding, then bags that fit. Ask: What the bag is for: day trips, storage, flying, or a road trip with several boards; Their board type and length (the longest if several); How many boards; How much protection, and must-have features. POST https://www.boardcave.com.au/api/agent/finders/bags For people: https://www.boardcave.com.au/bag-finder Example body: ```json {"use":"travel","count":2,"board":"shortboard","board_length":"6'2","widest":"fish"} ``` ### Leash Finder (leashes) The leash length for their board, the thickness for their waves, and ankle or knee cuff, then leashes in that length. Ask: Board type and length; The waves they usually surf; Less drag, all round, or strength first; Cuff preference and must-haves (optional). POST https://www.boardcave.com.au/api/agent/finders/leashes For people: https://www.boardcave.com.au/leash-finder Example body: ```json {"board":"shortboard","board_length":"6'2","waves":"medium"} ``` ### Tail Pad Finder (tailpads) A traction pad shaped for their board's tail (standard, wide tail, fish / swallow), with the kick height and arch for how they surf. Ask: Board type; How they surf it: sharp and vertical, all round, or relaxed; Kick and arch preference (optional); Whether they also want a front pad, eco only. POST https://www.boardcave.com.au/api/agent/finders/tailpads For people: https://www.boardcave.com.au/tail-pad-finder Example body: ```json {"board":"fish","style":"allround"} ``` ### Wax Finder (wax) The surf wax for where and when they surf, from local sea temperatures, plus a base coat for a new or stripped board. Ask: Where they surf (a listed region) and which months, or the water temperature; Whether they are waxing a new or freshly stripped board. POST https://www.boardcave.com.au/api/agent/finders/wax For people: https://www.boardcave.com.au/wax-finder Example body: ```json {"region":"Gold Coast QLD","months":["Dec","Jan","Feb"],"fresh":false} ``` ## Example ```bash curl -s -X POST https://www.boardcave.com.au/api/agent/finders/leashes -H 'Content-Type: application/json' -H 'X-Agent-Name: my-assistant' -d '{"board":"shortboard","board_length":74,"waves":"medium"}' ``` ## Pages for people - [Surfboard volume calculator](https://www.boardcave.com.au/surfboard-volume-calculator): the board finder as a page. - [Brands](https://www.boardcave.com.au/brands): every brand we stock. - [Stores and contact](https://www.boardcave.com.au/stores): retail locations and the customer team. - [The Surfer's Corner](https://www.boardcave.com.au/the-surfers-corner): surfing news, tips and product reviews. - [Sitemap](https://www.boardcave.com.au/sitemap.xml): every category and product page.