Who is the Helix API for?

Product teams and ATS or HRMS vendors who want candidate data inside their software, recruitment agencies who source at volume, companies building their own hiring workflows, and teams building AI assistants that need hiring data through MCP.

What do I get back about a candidate?

Search returns ranked summaries: role, seniority, experience and skills. Keys with the right scopes also receive contact details, self-reported compensation and a short-lived resume link. Access to each group of personal fields is controlled by scope and logged.

How is pay data produced, and how reliable is it?

Market pay combines curated benchmarks with percentiles of pay that candidates reported themselves, for the people nearest the role you ask about. It is unverified, groups under 5 people are never shown, and every answer carries a confidence level so you can decide how far to trust it.

How does pricing work?

A fixed monthly price in INR gives a monthly credit allowance. Each call costs a stated number of credits; market data, open roles and account calls are free. Credits reset each 30-day period. You can top up mid-period. GST is added at checkout.

Can I try it without paying?

Yes. Ask for a test key. It returns synthetic candidates with exactly the same response shapes as production, is never billed, and lets you build and test your whole integration first.

Do I get charged when a call fails?

No. Calls that fail on our side, are invalid, or find nothing are refunded in the same request. Safe retries use an Idempotency-Key header, and a replay costs nothing.

Is there an MCP server?

Yes. The same tools are available to Claude, Cursor and other Model Context Protocol clients at the /v1/mcp endpoint, with the same scopes and credits.

Where is it hosted and what is the uptime?

Requests enter through a global Cloudflare edge gateway and run on our application platform. We do not publish a contractual uptime figure; for enterprise commitments, contact us and we will agree terms for your engagement.

Helix API

Now available

Hiring data you can build on.

One REST API and MCP server over the Helix candidate pool: search, match, parse, benchmark pay and read open roles. Fixed monthly plans in rupees, test keys to start, and the safeguards an enterprise integration expects.

Documentation →OpenAPI spec Email us

From a job description to a shortlist, in two calls

curl

curl https://api.helixhumancapital.in/v1/match \
  -H "Authorization: Bearer $HELIX_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jobDescription": "Senior Backend Engineer, Bengaluru. 5+ years Python, PostgreSQL, AWS…", "limit": 10}'

# → requirements (must / nice) + ranked candidates, each with fit: "strong" | "possible" | "stretch"

Then open full records only for the people worth it: GET /v1/candidates/{id}. You pay 5 credits for a record, not for the ones you skip.

What you can build

ATS and HRMS vendors

Offer sourcing inside your product. Suggest candidates when a requisition opens, enrich records, and parse resumes on upload.

Recruitment agencies

Turn a client's job description into a ranked shortlist in one call, open full records only for strong fits, and keep a log of what you released.

Internal talent teams

Build a sourcing assistant or a Slack bot over the pool. Add market pay to every requisition before it is approved.

Compensation and HR analytics

Pull current and expected pay percentiles by role, seniority and city with an explicit confidence level, for budgeting and offer design.

AI assistants and agents

Connect Claude, Cursor or your own agent through MCP so it can search, match, parse and benchmark with a single key.

Job boards and career sites

Syndicate Helix open roles into your site, or match your visitors' job descriptions and resumes to the pool.

What is in the API

Candidate search

1 credit

Plain-language queries ranked by relevance, with filters for seniority, notice period, city, experience and expected pay.

Job-description matching

10 credits

Paste a JD. We extract must-haves and nice-to-haves, scan the pool, and return fit bands: strong, possible, stretch.

Fit scoring

3 credits

Score one known candidate against one role, with the same requirement checklist.

Full records

5 credits per record

Contact details, self-reported pay and a resume link, released only to keys with the matching scopes.

Resume and JD parsing

2 credits

PDF, DOC or DOCX to structured JSON. Job descriptions to requirement checklists. Nothing is stored.

Market pay bands

Free

Benchmarks plus observed percentiles with confidence levels. Top skills around a role. A map of the pool.

Open roles

Free

Helix's live job openings with salary ranges, level, work mode and location.

MCP server

Same as REST

Every tool above for Claude, Cursor and other agents, under the same scopes and credits.

Every endpoint is described in the API reference, generated from the same OpenAPI spec the service publishes.

Built for production

Scoped keys. Routes and personal-data fields are granted separately. Contact, pay and documents each need their own scope.
Audit trail. Every release of contact, pay or document fields is logged against your key.
Safe retries. Idempotency-Key on every POST. A replay returns the stored answer and costs nothing.
Refunds on failure. Server errors, invalid requests and not-found results are refunded automatically.
Exact rate limits. Per-minute limits are enforced precisely and returned with Retry-After.
Signed webhooks. Credit and subscription events, HMAC-signed, retried with backoff, with a delivery log.
Test keys. Synthetic data, identical shapes, never billed. Develop and run CI against it.
IP allowlists. Lock a key to your servers' addresses.
Global edge. Requests are filtered and rate-limited at Cloudflare before they reach the application.
Request ids. Every response carries one. Quote it and we can trace the call.

Details in Security and data handling.

Simple monthly pricing in rupees

A fixed price buys a monthly credit allowance. No per-seat fees, no overage surprises: when credits run out you top up or wait for renewal. Prices exclude 18% GST, added and shown at checkout.

Pro

₹14,999

per 30-day period

3,000 credits
60 requests per minute
Top-ups: 1,000 credits for ₹6,000
≈ ₹5 per credit

Products and small teams putting candidate search, parsing or market data into a workflow.

Pro Scale

₹49,999

per 30-day period

15,000 credits
300 requests per minute
Top-ups: 1,000 credits for ₹4,000
≈ ₹3.33 per credit

Agencies, ATS vendors and high-volume sourcing, at about one third less per credit.

Client

Custom

by arrangement

Credits agreed with you
120 requests per minute
Invoicing and custom scopes

Helix clients and negotiated volumes: custom allowance, scopes and invoicing, set up by us.

What each call costs

Call	Credits
Search (summaries)	1
Full candidate record (each)	5
Resume download link	2
Parse a resume or a job description	2
Fit score for one candidate	3
Match a job description to the pool	10
Market pay, skills, overview, open roles, account	Free

Worked example: match a job description (10) and open five full records (25) is 35 credits, so Pro covers about 85 such shortlists a month. Full detail in Credits and billing.

How to get started

Request a test key with your company and use case. It returns synthetic data and is never billed.
Build against the docs. Import the OpenAPI spec into Postman or generate a client. Try the quickstart.
Go live. Pick a plan, pay online by UPI, card or netbanking, and switch your key. Same code, real data.
Operate it. Add a webhook for low credits, an IP allowlist, and check usage any time at /v1/usage.

Frequently asked questions

Who is the Helix API for?: Product teams and ATS or HRMS vendors who want candidate data inside their software, recruitment agencies who source at volume, companies building their own hiring workflows, and teams building AI assistants that need hiring data through MCP.
What do I get back about a candidate?: Search returns ranked summaries: role, seniority, experience and skills. Keys with the right scopes also receive contact details, self-reported compensation and a short-lived resume link. Access to each group of personal fields is controlled by scope and logged.
How is pay data produced, and how reliable is it?: Market pay combines curated benchmarks with percentiles of pay that candidates reported themselves, for the people nearest the role you ask about. It is unverified, groups under 5 people are never shown, and every answer carries a confidence level so you can decide how far to trust it.
How does pricing work?: A fixed monthly price in INR gives a monthly credit allowance. Each call costs a stated number of credits; market data, open roles and account calls are free. Credits reset each 30-day period. You can top up mid-period. GST is added at checkout.
Can I try it without paying?: Yes. Ask for a test key. It returns synthetic candidates with exactly the same response shapes as production, is never billed, and lets you build and test your whole integration first.
Do I get charged when a call fails?: No. Calls that fail on our side, are invalid, or find nothing are refunded in the same request. Safe retries use an Idempotency-Key header, and a replay costs nothing.
Is there an MCP server?: Yes. The same tools are available to Claude, Cursor and other Model Context Protocol clients at the /v1/mcp endpoint, with the same scopes and credits.
Where is it hosted and what is the uptime?: Requests enter through a global Cloudflare edge gateway and run on our application platform. We do not publish a contractual uptime figure; for enterprise commitments, contact us and we will agree terms for your engagement.

Start with a test key

Tell us what you are building and we will send a test key. Move to a paid plan when you are ready; nothing about your code changes.

Request a key →Read the docs →

Compensation figures are self-reported by candidates and unverified. Plan prices exclude GST. Helix does not publish a contractual uptime figure; enterprise terms are agreed individually.