API Documentation

This page describes how to submit enquiries to the BananaSystems API from software agents and browser clients.

Endpoint

POST /api/enquiry

Supported Content Types

• application/json
• application/x-www-form-urlencoded

Required Fields

• full_name (string)
• email (valid email)
• project_description (string)

Optional Fields

• organisation (string)
• budget (number, GBP)
• project_type (ad-hoc, basic-plan, premium-plan, custom)
• company_website (honeypot field; leave empty)

Rate Limit

Maximum 5 submissions per IP address per hour.

Example cURL (JSON)

curl -X POST "https://bananasystems.co.uk/api/enquiry" \
  -H "Content-Type: application/json" \
  -d '{
    "full_name": "Jane Smith",
    "email": "jane@example.com",
    "project_description": "Need a bespoke booking system integrated with CRM",
    "organisation": "South Coast Plumbing Ltd",
    "budget": 3000,
    "project_type": "custom",
    "company_website": ""
  }'

Example Payload

{
  "full_name": "Jane Smith",
  "email": "jane@example.com",
  "project_description": "Need a bespoke booking system integrated with CRM",
  "organisation": "South Coast Plumbing Ltd",
  "budget": 3000,
  "project_type": "custom",
  "company_website": ""
}

Example Success Response

{
  "status": "success",
  "message": "Enquiry received",
  "reference_id": "BS-2026-0421"
}

Example Error Response

{
  "status": "error",
  "message": "Validation failed",
  "errors": {
    "email": "Invalid email format"
  }
}

OpenAPI Spec

Machine-readable schema: /openapi.json