POST /api/contact

Submits a contact inquiry. Two doors are supported: federal (contracting officer / agency intake) and commercial (business inquiry / consulting). The core fields are the same; door-specific optional fields are passed through.

Quick reference

Method	`POST`
URL	`https://truvisory.com/api/contact`
Request	`application/json`
Response	`application/json`
OpenAPI	contact.json

Request body

Required (both doors)

Field	Type	Description
`door`	enum	`federal` \| `commercial`
`name`	string	Submitter's name.
`email`	string (email)	Reply-to email.
`message`	string	Inquiry body. Minimum 10 characters.

Federal door (optional)

Field	Type	Description
`title`	string	Submitter's title (e.g., Contracting Officer).
`agency`	string	Agency or component.
`inquiryType`	string	Category (e.g., `sole-source`, `RFI-response`).
`solicitation`	string	Solicitation or RFI number.

Commercial door (optional)

Field	Type	Description
`phone`	string	Contact phone.
`company`	string	Company name.
`role`	string	Submitter's role.
`exploring`	string	What the prospect is exploring (e.g., `audit`, `sprint`).
`stage`	string	Stage of evaluation.

Metadata (optional)

Field	Type	Description
`page`	string	Page path the form was submitted from.
`referrer`	string	`document.referrer` at submit time.

Response (200)

{ "ok": true, "id": 1023 }

Errors

Status	Body (`error`)	Cause
400	`invalid_door`	`door` is missing or not `federal`/`commercial`.
400	`name_required`	Empty/missing `name`.
400	`email_invalid`	Missing or malformed `email`.
400	`message_too_short`	`message` shorter than 10 characters.
400	`invalid_json`	Body is not parseable JSON.
413	`payload_too_large`	Body exceeds the size limit.
429	`rate_limited`	Too many submissions from this IP.

Example — federal

curl -X POST https://truvisory.com/api/contact \
  -H 'content-type: application/json' \
  -d '{
    "door": "federal",
    "name": "Pat KO",
    "email": "pat@agency.gov",
    "title": "Contracting Officer",
    "agency": "DHS / CISA",
    "inquiryType": "sole-source",
    "solicitation": "70RCSA26Q00001234",
    "message": "Requesting a capability statement and SDVOSB confirmation."
  }'