Quickstart: Time to First Quote

Before you integrate Malcolm into your AI agent or application, use this quickstart to authenticate and generate a test quote in our Sandbox environment.

1. Get your sandbox API keys

Email us at contact@trymalcolm.com and we'll set you up with test credentials for you to explore Malcolm.

2. Generate a test quote

Malcolm's Sandbox environment (https://sandbox.api.trymalcolm.com/v1) allows you to test our canonical schemas without hitting live carrier pricing.

Run this standard cURL request to generate a mock Home & Contents quote:

curl -X POST [https://sandbox.api.trymalcolm.com/v1/quotes](https://sandbox.api.trymalcolm.com/v1/quotes) \
  -H "Authorization: Bearer sk_test_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "schema": "malcolm/v1",
    "class_of_business": "home_contents",
    "payload": {
      "property_type": "semi_detached",
      "postcode": "SW1A 1AA",
      "buildings_cover": true,
      "contents_value": 50000,
      "cover_limit": 500000
    }
  }'

3. Review the response

You should immediately receive a 200 OK response with a mock quote, demonstrating our deterministic compliance flags:

{
  "status": "success",
  "quote_id": "mq_test_88192a",
  "pricing": {
    "premium_monthly": 14.20,
    "currency": "GBP"
  },
  "compliance_flags": {
    "hallucination_check": "passed",
    "fca_prod4_status": "compliant"
  }
}

4. Choose your integration path

Now that you've verified the API works, how do you want to implement it?

I am building a custom AI Assistant ➔ (Learn how to expose Malcolm's quote-fetching tools to your LLM).

I want to drop a UI into my website ➔ (Learn how to embed our conversational Sidecar UI).