n7.nzPublic CV API

CV as API

Structured CV data, negotiated representations, versioned routes, ranked search, and contract governance packaged as a real API product.

View CVExplore UIOpen APIOpenAPI SpecPostmanTS ClientGitHub
Endpoints17
Versionv1
CachingETag + 304
AuthBearer (Private)
SpecOpenAPI 3.1
ContractLinted + Checked
Use Case

Machine-readable CV

Use the API directly from scripts, dashboards, or other portfolio tooling instead of scraping a PDF or duplicating data by hand.

Use Case

Fast opportunity triage

Score listings or briefs against the CV with a deterministic matcher that is cheap to run and easy to reason about.

Use Case

Public technical signal

Show API design, versioning, negotiation, docs quality, and contract governance through the artifact itself rather than describing them abstractly.

GET /api/v1/cv

The canonical v1 CV document. Supports optional partial responses through `sections` and `fields` so clients can pull only the slices they need.

Selecting an endpoint loads its contract preview. Use Run request when you want live timings, headers, and a fresh payload.

PrimaryProjectableVersioned

Parameters

NameTypeRequiredDescription
sectionsstringNoComma-separated top-level sections such as meta,projects
fieldsstringNoComma-separated field paths such as meta.name,projects.url

Notes

  • The sample request demonstrates projection with `sections` and `fields`.
  • Remove the query string to retrieve the full CV document in one response.
  • Cacheable GET routes now emit `ETag` and `Last-Modified` headers for conditional requests.
  • Alternate media types are available on the same route through the `Accept` header.

Example Request

curl https://www.n7.nz/api/v1/cv?sections=meta,projects&fields=meta.name,meta.title,projects.name,projects.url

Response

Preview payload. Run request for live timings and headers.
{  "meta": {    "name": "Phil Smith",    "title": "Senior Technical BA & Integration Analyst"  },  "projects": [    {      "name": "SecondBrain",      "url": "#"    },    {      "name": "ContractRadar",      "url": "#"    },    {      "name": "GovRadar",      "url": "#"    },    {      "name": "SpecCheck",      "url": "#"    },...