LeadSubmission

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/immix/json-schema/immix-lead-submission-schema.json",
  "title": "LeadSubmission",
  "x-generated": "2026-10-29",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/immix-enquiry-openapi.json#/components/schemas/LeadSubmission",
  "type": "object",
  "required": [
    "kind",
    "payload"
  ],
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "brief",
        "pilot",
        "contact"
      ],
      "description": "Which capture surface produced the enquiry. The site form sends \"contact\"."
    },
    "payload": {
      "$ref": "#/$defs/ContactPayload"
    },
    "idempotencyKey": {
      "type": "string",
      "description": "Optional. Accepted for compatibility and ignored: the server derives its own key from the content."
    },
    "sentAt": {
      "type": "string",
      "format": "date-time"
    }
  },
  "$defs": {
    "ContactPayload": {
      "type": "object",
      "required": [
        "email",
        "message",
        "consent"
      ],
      "properties": {
        "email": {
          "type": "string",
          "format": "email",
          "maxLength": 254,
          "description": "Work email. Free-mail domains are rejected by the form; the API accepts any syntactically valid address."
        },
        "company": {
          "type": "string",
          "maxLength": 200
        },
        "pairs": {
          "type": "string",
          "maxLength": 160,
          "description": "The currencies or stablecoins of interest, free text."
        },
        "topic": {
          "type": "string",
          "maxLength": 80,
          "enum": [
            "Trade non-USD stablecoin FX",
            "Market making for our stablecoin",
            "Liquidity for our venue or platform",
            "Price a payment corridor",
            "Other enquiry"
          ],
          "description": "One of the form's topics, exactly as listed; any other value is refused with 400."
        },
        "message": {
          "type": "string",
          "maxLength": 4000
        },
        "consent": {
          "type": "boolean",
          "const": true,
          "description": "Must be true: consent to IMMIX processing the enquiry in order to respond to it (see /legal/privacy)."
        }
      }
    }
  }
}