Honest Fit LogoHonestFit

Public API documentationv1partner

Contact-led, scoped-key access to the same public-safe candidate profile and public-fit data a candidate chooses to expose on their `/c/...` page. This is a discoverable reference surface, not anonymous API access.

Discovery

What agents and partners should know

The v1 API is server-to-server. Callers need a Bearer API key with the right scope, and responses stay inside the candidate-controlled public projection. Canonical/private profile fields, raw evidence, provider internals, admin data, and recruiter workflow data are not part of this surface.

Base path

https://honestfit.ai/api/v1

Authorization

Authorization: Bearer <api_key>

Access model

Contact-led partner keys; no anonymous API access

Read scope

public_candidate.read

Fit scope

public_candidate.fit

Public boundary

Candidate-controlled public projection only

Public docs are readable without a key. API calls are not: production endpoints requireAuthorization: Bearer <api_key>with public_candidate.read and/or public_candidate.fit.

Machine-readable

These public paths are served from the existing source-of-truth files underdocs/api/.