{"openapi":"3.1.0","info":{"title":"C2Consultants API","version":"1","description":"Reading is open. A request authorizes nothing. An order is an order request that a person confirms, invoices and starts; nothing is charged by the API. Every request and order is acknowledged by email with its id.\n\nA request (POST /api/v1/requests) is read and answered by a person within one business day; it authorizes nothing, and any work is agreed in writing.\nAn order (POST /api/v1/orders) is an order request: the API records it and acknowledges it, and a person confirms scope, invoices and starts the work. The API charges, books and starts nothing. IntentSharp licences are bought by a person at https://intentsharp.com/pricing; an order request tells us to expect the purchase and to help.\nThere is no database: every request and order gets a time-sortable id, a notification to us and an acknowledgment email to the requester, and that acknowledgment is the durable record.\nLimits: 10 writes per minute per client address (429 with Retry-After), 16384-byte bodies.","contact":{"name":"C2Consultants, LLC","email":"requests@C2Consultants.net","url":"https://c2consultants.net/for-agents/"}},"servers":[{"url":"https://c2consultants.net"}],"paths":{"/api/v1/catalog":{"get":{"operationId":"getCatalog","summary":"What C2Consultants offers, what each offering requires and costs, and whether it is ordered or requested.","responses":{"200":{"description":"The catalog. Any origin may read it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}}}}}}},"/api/v1/requests":{"post":{"operationId":"createRequest","summary":"Send a question, follow-up, request for details or a demo, pilot scoping, or a partnership enquiry.","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Optional, 1-200 printable ASCII characters. Echoed in the response and in both emails. It is NOT stored and NOT used to deduplicate: there is no database, so sending the same key twice sends two requests.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestBody"},"example":{"kind":"demo","offeringId":"c2empowered-pilot","contact":{"name":"Dana Lee","email":"dana@example.com","organization":"Example Paving"},"message":"We re-key invoices from email into our ERP every day. Could we see a demo?","context":{"agent":"ExampleAssistant/1.0","onBehalfOf":"Dana Lee"}}}}},"responses":{"202":{"description":"Received. A person replies within one business day.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestAccepted"},"example":{"ok":true,"requestId":"req_01kcd2m7x4p9q3rt","kind":"demo","offeringId":"c2empowered-pilot","receivedAt":"2026-11-02T15:04:05.000Z","acknowledgment":"sent to dana@example.com","humanReply":"within one business day","authorizes":"nothing; any work is agreed in writing","status":"received"}}}},"400":{"description":"Validation failed. Each problem is one item in errors.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"ok":false,"errors":["contact.email is not valid."]}}}},"413":{"description":"Body larger than 16384 bytes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"ok":false,"errors":["Body must be at most 16384 bytes."]}}}},"429":{"description":"More than 10 writes in a minute from one address.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"ok":false,"errors":["Too many writes: at most 10 per minute from one address. Retry after 42 seconds."]}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}}},"502":{"description":"Mail delivery failed, so nothing was recorded. Retry, or email requests@c2consultants.net.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"ok":false,"errors":["Mail delivery failed, so the request was not recorded. Retry, or email requests@c2consultants.net directly."]}}}}}}},"/api/v1/orders":{"post":{"operationId":"createOrderRequest","summary":"Send an order request for the C2Empowered pilot or an IntentSharp licence. Nothing is charged.","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Optional, 1-200 printable ASCII characters. Echoed in the response and in both emails. It is NOT stored and NOT used to deduplicate: there is no database, so sending the same key twice sends two requests.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderBody"},"examples":{"pilot":{"value":{"offeringId":"c2empowered-pilot","contact":{"name":"Dana Lee","email":"dana@example.com","organization":"Example Paving"},"purchaseOrder":"PO-1042","notes":"Invoice intake from email into Viewpoint.","acceptsTerms":true}},"intentsharp":{"value":{"offeringId":"intentsharp-licence","contact":{"name":"Sam Ortiz","email":"sam@example.com"},"quantity":5,"acceptsTerms":true}}}}}},"responses":{"202":{"description":"Order request received. A person confirms it; nothing has been charged.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PilotOrderAccepted"},{"$ref":"#/components/schemas/LicenceOrderAccepted"}]},"examples":{"pilot":{"value":{"ok":true,"orderId":"ord_01kcd2m7x4k2v8wn","offeringId":"c2empowered-pilot","receivedAt":"2026-11-02T15:04:05.000Z","status":"order request received","whatHappensNext":"A person confirms scope and sends an engagement letter and invoice for the fixed-fee items ($1,750 installation, $2,000 discovery). Nothing has been charged.","lineItems":[{"name":"Installation","amount":1750,"unit":"fixed fee"},{"name":"Discovery","amount":2000,"unit":"fixed fee"},{"name":"Workflow build","amount":175,"unit":"per hour, as billed"}],"acknowledgment":"sent to dana@example.com"}},"intentsharp":{"value":{"ok":true,"orderId":"ord_01kcd2m7x4h6c1ze","offeringId":"intentsharp-licence","receivedAt":"2026-11-02T15:04:05.000Z","status":"order request received","humanCheckoutUrl":"https://intentsharp.com/pricing","whatHappensNext":"Licences are bought at the checkout above by a person; this order request tells us to expect it and to help. Nothing has been charged.","pricing":{"fromUsdPerDeveloperPerYear":349,"quantity":5},"acknowledgment":"sent to sam@example.com"}}}}}},"400":{"description":"Validation failed, or the offering is requested rather than ordered.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"ok":false,"errors":["partnership is requested, not ordered: use POST /api/v1/requests with kind 'partnership' and offeringId 'partnership'"]}}}},"413":{"description":"Body larger than 16384 bytes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"ok":false,"errors":["Body must be at most 16384 bytes."]}}}},"429":{"description":"More than 10 writes in a minute from one address.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"ok":false,"errors":["Too many writes: at most 10 per minute from one address. Retry after 42 seconds."]}}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}}},"502":{"description":"Mail delivery failed, so nothing was recorded. Retry, or email requests@c2consultants.net.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"ok":false,"errors":["Mail delivery failed, so the request was not recorded. Retry, or email requests@c2consultants.net directly."]}}}}}}},"/api/contact":{"post":{"operationId":"submitContactForm","summary":"The website's contact form endpoint. Sends one email to C2Consultants; no acknowledgment, no id.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactForm"},"example":{"site":"c2consultants","name":"Dana Lee","email":"dana@example.com","subject":"C2Empowered pilot","message":"We re-key invoices from email into our ERP every day."}}}},"responses":{"204":{"description":"Sent (or silently dropped when the _gotcha spam trap is filled)."},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"ok":false,"errors":["Email is not valid."]}}}},"502":{"description":"Mail delivery failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"ok":false,"errors":["Mail delivery failed. Please email requests@c2consultants.net directly."]}}}}}}}},"components":{"schemas":{"Error":{"type":"object","required":["ok","errors"],"properties":{"ok":{"const":false},"errors":{"type":"array","items":{"type":"string"}}}},"Contact":{"type":"object","required":["name","email"],"properties":{"name":{"type":"string","minLength":1,"maxLength":200},"email":{"type":"string","format":"email","maxLength":320},"organization":{"type":"string","maxLength":200},"phone":{"type":"string","maxLength":60}}},"Context":{"type":"object","description":"Who is sending: the program, and the person or organization it acts for.","properties":{"agent":{"type":"string","maxLength":200},"onBehalfOf":{"type":"string","maxLength":200},"references":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":2000}}}},"RequestBody":{"type":"object","required":["kind","contact","message"],"properties":{"kind":{"type":"string","enum":["question","follow-up","details","demo","pilot-scoping","partnership"]},"offeringId":{"type":"string","enum":["c2empowered-pilot","intentsharp-evaluation","intentsharp-licence","partnership","binary-intelligence-design-partnership"]},"contact":{"$ref":"#/components/schemas/Contact"},"message":{"type":"string","minLength":5,"maxLength":5000},"context":{"$ref":"#/components/schemas/Context"}}},"RequestAccepted":{"type":"object","required":["ok","requestId","kind","receivedAt","acknowledgment","humanReply","authorizes","status"],"properties":{"ok":{"const":true},"requestId":{"type":"string","pattern":"^req_[0-9a-hjkmnp-tv-z]{16}$"},"kind":{"type":"string","enum":["question","follow-up","details","demo","pilot-scoping","partnership"]},"offeringId":{"type":"string"},"receivedAt":{"type":"string","format":"date-time"},"acknowledgment":{"type":"string","description":"\"sent to <email>\", or why it was not sent."},"humanReply":{"const":"within one business day"},"authorizes":{"const":"nothing; any work is agreed in writing"},"status":{"const":"received"},"idempotencyKey":{"type":"string"},"dryRun":{"const":true,"description":"Present only when the server runs with MAIL_DRY_RUN=1 (no email sent)."}}},"OrderBody":{"type":"object","required":["offeringId","contact","acceptsTerms"],"properties":{"offeringId":{"type":"string","enum":["c2empowered-pilot","intentsharp-licence"]},"contact":{"$ref":"#/components/schemas/Contact"},"quantity":{"type":"integer","minimum":1,"maximum":50,"description":"IntentSharp developers (intentsharp-licence only; default 1)."},"purchaseOrder":{"type":"string","maxLength":100},"notes":{"type":"string","maxLength":5000},"acceptsTerms":{"const":true,"description":"Must be true: the requester has read that this creates an order request for a person to confirm, not a charge."},"context":{"$ref":"#/components/schemas/Context"}}},"LineItem":{"type":"object","required":["name","amount","unit"],"properties":{"name":{"type":"string"},"amount":{"type":"number"},"unit":{"type":"string"}}},"PilotOrderAccepted":{"type":"object","required":["ok","orderId","offeringId","receivedAt","status","whatHappensNext","lineItems","acknowledgment"],"properties":{"ok":{"const":true},"orderId":{"type":"string","pattern":"^ord_[0-9a-hjkmnp-tv-z]{16}$"},"offeringId":{"const":"c2empowered-pilot"},"receivedAt":{"type":"string","format":"date-time"},"status":{"const":"order request received"},"whatHappensNext":{"type":"string"},"lineItems":{"type":"array","items":{"$ref":"#/components/schemas/LineItem"}},"acknowledgment":{"type":"string"},"idempotencyKey":{"type":"string"},"dryRun":{"const":true}}},"LicenceOrderAccepted":{"type":"object","required":["ok","orderId","offeringId","receivedAt","status","humanCheckoutUrl","whatHappensNext","pricing","acknowledgment"],"properties":{"ok":{"const":true},"orderId":{"type":"string","pattern":"^ord_[0-9a-hjkmnp-tv-z]{16}$"},"offeringId":{"const":"intentsharp-licence"},"receivedAt":{"type":"string","format":"date-time"},"status":{"const":"order request received"},"humanCheckoutUrl":{"const":"https://intentsharp.com/pricing"},"whatHappensNext":{"type":"string"},"pricing":{"type":"object","required":["fromUsdPerDeveloperPerYear","quantity"],"properties":{"fromUsdPerDeveloperPerYear":{"type":"number"},"quantity":{"type":"integer"}}},"acknowledgment":{"type":"string"},"idempotencyKey":{"type":"string"},"dryRun":{"const":true}}},"Offering":{"type":"object","required":["id","name","kind","summary","forWhom","requiresToStart","constraints","pricing","canOrderViaApi","requestKind"],"properties":{"id":{"type":"string","enum":["c2empowered-pilot","intentsharp-evaluation","intentsharp-licence","partnership","binary-intelligence-design-partnership"]},"name":{"type":"string"},"kind":{"type":"string","enum":["pilot","evaluation","licence","partnership","design-partnership"]},"summary":{"type":"string"},"forWhom":{"type":"string"},"url":{"type":"string","format":"uri"},"requiresToStart":{"type":"array","items":{"type":"string"}},"constraints":{"type":"array","items":{"type":"string"}},"pricing":{"description":"Pilot: {currency, items[], afterThePilot}. IntentSharp: {currency, fromUsdPerDeveloperPerYear, evaluationDays, details}. Others: {quoted: true, note}.","type":"object"},"canOrderViaApi":{"type":"boolean","description":"true: POST /api/v1/orders. false: POST /api/v1/requests with requestKind."},"requestKind":{"type":"string","enum":["question","follow-up","details","demo","pilot-scoping","partnership"]},"humanCheckoutUrl":{"type":"string","format":"uri"}}},"Catalog":{"type":"object","required":["version","organization","offerings"],"properties":{"version":{"const":"1"},"organization":{"type":"object"},"authorization":{"type":"string"},"offerings":{"type":"array","items":{"$ref":"#/components/schemas/Offering"}}}},"ContactForm":{"type":"object","required":["site","name","email","message"],"properties":{"site":{"type":"string","enum":["c2consultants","binaryintelligence"]},"name":{"type":"string","maxLength":200},"email":{"type":"string","format":"email","maxLength":320},"message":{"type":"string","minLength":5,"maxLength":5000},"organization":{"type":"string","maxLength":200},"phone":{"type":"string","maxLength":60},"subject":{"type":"string","maxLength":200},"_gotcha":{"type":"string","description":"Spam trap: leave empty or omit."}}}}}}