API Reference

The Faction API exposes four primary endpoints for quote handling, plus auxiliary endpoints for async jobs, feedback, and health.

Servers

Environment	Base URL
Production (EU)	`https://api.eu.faction.ai/v1`
Sandbox / staging	`https://api.eu.sandbox.faction.ai/v1`

Authentication

All endpoints (except /healthz and /readyz) require a bearer token obtained via OAuth2 client credentials.

POST https://auth.eu.faction.ai/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&client_id=...
&client_secret=...
&scope=intent.classify+extract.quote+match.customer+match.product

The returned access_token is then sent on each call:

Authorization: Bearer <access_token>

Headers used everywhere

Header	Required	Notes
`Authorization: Bearer <token>`	Yes (except health)	OAuth2 access token.
`X-Correlation-Id`	Yes	Caller-supplied. Propagated end-to-end.
`Idempotency-Key`	Optional	If reused within 24h with the same payload, the cached response is returned.
`Prefer: respond-async`	Optional	Returns 202 with a job ID for long-running calls.
`Faction-Callback-Url`	Optional	Webhook for async results.

Endpoints

Quote handling

Classify intent (POST /intent/classify)
Extract quote info (POST /extract/quote)
Match customer (POST /match/customer)
Match product (POST /match/product)

Auxiliary

Get job status (GET /jobs/{job_id})
Submit feedback (POST /feedback)
Health probes (GET /healthz, GET /readyz)