Plan the hire.
Request a quote.
Help a customer choose equipment and prepare a complete enquiry. Our team confirms availability and the final price.
OpenAPI specification (JSON) · Live product catalogue (JSON)
1. Find the right products
Read the live catalogue’s products and categories. Use product id, not a name match. For products with seat pads, choose a seatPads[].id as seatPadId; this is the option relationship ID, not its productId. Do not invent a choice.
Guide prices are GBP base hire rates, excluding VAT and delivery. They are not daily rates or live availability. A missing price means price on request. For larger marquee planning, use our marquee quote builder.
2. Agree the details with the customer
Collect name, email, phone, occasion, hire start, event date and hire end. Ask whether they want delivery or collection/return at Amersham. Delivery requires the address, city and postcode. Include access requirements and other relevant information in notes.
Obtain permission to share their details and send a confirmation email. Explain the terms and conditions. Never guess consent, dates, contact details or options. Unconfirmed details expire after 24 hours and are cleared by the hourly cleanup. For questions about personal information, contact our team.
3. Validate, then submit
Send JSON to https://wastaff.com/api/agent_quote.php. Use action: "validate" first; this checks the request without saving it or emailing anyone. Then send action: "submit" with the same fields. Examples and field limits are in the specification.
Use a fresh lowercase UUID for requestKey. Reuse it with identical details when retrying; do not generate another key after a timeout. Duplicate protection lasts seven days. Browser integrations should use Content-Type: text/plain;charset=UTF-8 to avoid the host’s preflight limitations. Server integrations can use application/json.
4. Let the customer confirm
An anonymous submission returns 202 awaiting_customer_confirmation. We email a private link to the customer. They review the items and details and press Confirm quote request within 24 hours. Opening the link alone does not submit anything. Unconfirmed requests stay outside the staff queue.
Do not ask for or collect their confirmation token. If details need changing, prepare a corrected request with their permission. The old one can expire. Confirmation rechecks products, options and dates.
Approved partners
Approved server integrations may use a separately issued, expiring bearer credential. Their submissions enter staff review directly and return a YEH-… reference. Credentials identify the integration; customer permission is still required. Keep keys on your server. Contact us to arrange access.
Limits and safe retries
- 1–40 product/option groups; 1–999 of each. Combine identical groups.
- Dates must be today or later, within three years, and ordered hire start ≤ event ≤ hire end.
- Anonymous requests: 5 per IP per hour and 3 per customer email per hour. Approved partners: 20 per credential/IP per hour. A global limit also applies.
400: correct invalid fields.401: fix partner credentials.409: a request key was reused with changed details.410: expired confirmation.429: respect Retry-After.503: retry the same key unless the code isemail_unconfirmed; ask the customer to check their inbox or contact us in that case.
No CAPTCHA is required for this API. Submission does not take payment, reserve stock or create a Current RMS quote. Staff review confirmed enquiries before preparing a quotation.