Authentication

All requests to the FairFigure Ingest API must be authenticated using your partner API key.

API Key Authentication

Include your API key in the Authorization header of every request:

Authorization: Bearer YOUR_API_KEY

Example Request

curl -X POST https://fairfigure.com/api/v1/capital/ingest \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "business_name": "Acme Corp",
    "ein": "123456789"
  }'

Authentication Errors

Status	Response	Cause
401	{"error": "Unauthorized: API Key missing"}	No Authorization: Bearer header was sent
401	{"error": "Unauthorized: Invalid API Key"}	The API key is not recognized
403	{"error": "Unauthorized: Partner account is inactive"}	The partner account has been deactivated; contact partner support

Obtaining an API Key

INFO

To obtain a partner API key, contact the FairFigure partner team at [email protected]

Security Best Practices

Practice	Description
Keep Keys Secret	Never expose your API key in client-side code or public repositories
Use HTTPS	Always make requests over HTTPS to ensure your API key is encrypted in transit
Rotate Keys	Periodically rotate your API keys and update them in your systems