Developer API

Contract search, with IR35 context.

The public endpoint is read-only and requires no API key for normal interactive use. It returns active indexed roles, source freshness and explicit status evidence fields.

Production-shaped data

No write or application scope

JSON responses with cache headers

GET

https://www.ir35careers.com/api/jobs/search
?q=react
&ir35=outside
&min_rate=600
&per_page=20

Query parameters

q: Role, company or description search
location: UK town or region substring
ir35: outside, inside or tbc
remote: remote, hybrid or onsite
min_rate: Minimum advertised day rate
skills: Comma-separated canonical skills
within_days: 1 to 60 days
sort: recent, rate_high or rate_low
page / per_page: Pagination; up to 50 per page

Read-only command-line helper

Search IR35-aware contracts or analyse a public job URL from a terminal. It uses the same public endpoints, needs no account, and has no application-submission permission.

Download CLI helper

Examples

node ir35careers-cli.mjs search "platform engineer"
node ir35careers-cli.mjs analyse "https://example.com/job"

MCP server · available

Bring contract discovery into your MCP host

The downloadable Node.js server exposes public search, contract detail, safe public-URL analysis and IR35 evidence explanations. It has no sign-in, CV, messaging or application permission.

Download MCP server View connection states

Install

unzip ir35careers-mcp-v1.zip
cd ir35careers-mcp
npm install
npm run self-test

Requires Node.js 20+. Configure your host to run node /absolute/path/server.mjs. The included README contains a ready-to-copy host configuration.