HackerRank for Work API

Name: HackerRank for Work API
Brand: HackerRank for Work API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentHR recruitingRecruiting Atsbasic, bearer42 EndpointsREST

For Agents

Manage HackerRank for Work users, teams, tests, candidates, interviews, and questions for technical hiring workflows from an ATS or recruiting agent.

Install Jentic One Beta

Connect the HackerRank for Work API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the HackerRank for Work API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with HackerRank for Work API.

Manage recruiter and admin users, role assignments, and team membership

List, create, and archive technical assessment tests

Invite candidates to a test and pull their score reports as PDF or JSON

GET STARTED

Start building with HackerRank for Work API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use HackerRank for Work API for, with concrete tasks.

★ ATS-Driven Test Invitations

Connect HackerRank for Work to an applicant tracking system so each candidate moved to the technical screen stage receives an invitation automatically. The agent watches the ATS for stage transitions, calls /x/api/v3/tests/{test_id}/candidates with the candidate's email, and pulls the score back when the candidate completes. Recruiters get assessment results inside the ATS without manual copying.

POST /x/api/v3/tests/{test_id}/candidates with the candidate's email and full name, then GET /x/api/v3/tests/{test_id}/candidates/{candidate_id}/invite to send the invite link.

Score Report Aggregation

Pull score data nightly to build a hiring funnel dashboard that tracks pass rate by test, by team, and by source channel. The agent lists all candidates per test, aggregates the score and time fields, and writes them into a BI warehouse. Useful for talent ops teams justifying assessment spend and tuning question difficulty.

GET /x/api/v3/tests, then for each test GET /x/api/v3/tests/{test_id}/candidates, and write each candidate's score, status, and time_taken to the warehouse.

Interview Scheduling Agent

Build a scheduler that creates HackerRank pair-coding interviews from calendar invites. The agent reads a calendar event, calls /x/api/v3/interviews to create the interview with the linked candidate and template, and posts the interview URL back into the calendar event description. Interviewers get a ready-to-run pad without manual setup.

POST /x/api/v3/interviews with the candidate id, template id, and start time, then update the calendar event with the returned interview URL.

Compliance Audit Pull

Generate quarterly audit reports of recruiter activity by reading /x/api/v3/audit_log filtered by user and date range. The agent normalises the events into a compliance-friendly format and stores them in the document of record. Useful for SOC 2 audits and bias-monitoring programmes.

GET /x/api/v3/audit_log filtered by the past 90 days and emit a CSV with timestamp, user_id, action, and target.

Agent Discovery Through Jentic

Recruiting agents discover HackerRank operations by searching Jentic with intents like 'invite candidate to a coding test'. Jentic returns the matching candidate-creation operation with its input schema. Credentials are isolated in the Jentic vault.

Use Jentic search 'invite candidate to a hackerrank test' to find POST /x/api/v3/tests/{test_id}/candidates and execute it with email and full_name.

Key Endpoints

42 endpoints — hackerrank for work is a technical hiring platform used to assess and interview software engineers.

METHOD

PATH

DESCRIPTION

GET

/x/api/v3/tests

List all assessment tests

POST

/x/api/v3/tests/{test_id}/candidates

Add a candidate to a test

GET

/x/api/v3/tests/{test_id}/candidates/{candidate_id}/invite

Send the invitation email

GET

/x/api/v3/tests/{test_id}/candidates/{candidate_id}/pdf

Download the score report PDF

POST

/x/api/v3/interviews

Schedule a pair-coding interview

GET

/x/api/v3/interview_templates

List interview templates

GET

/x/api/v3/audit_log

Read recruiter activity events

GET

/x/api/v3/tests

List all assessment tests

POST

/x/api/v3/tests/{test_id}/candidates

Add a candidate to a test

GET

/x/api/v3/tests/{test_id}/candidates/{candidate_id}/invite

Send the invitation email

GET

/x/api/v3/tests/{test_id}/candidates/{candidate_id}/pdf

Download the score report PDF

POST

/x/api/v3/interviews

Schedule a pair-coding interview

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

HackerRank Basic auth credentials and Bearer tokens are stored encrypted in the Jentic vault. Agents receive scoped access tokens and never see the raw recruiter credentials.

Intent-based discovery

Agents search Jentic for intents like 'invite candidate to a coding test' or 'schedule a pair-coding interview' and receive the matching HackerRank operation with its input schema.

Time to first call

Direct HackerRank integration: 2-3 days to handle dual auth modes, candidate state transitions, and PDF report retrieval. Through Jentic: under an hour to search, load, and execute.

FAQs

Specific to using HackerRank for Work API through Jentic.

What authentication does the HackerRank for Work API use?

HackerRank for Work supports HTTP Basic auth with username and API key, and Bearer token auth using a token generated from the platform settings. Through Jentic, both credential types are stored encrypted in the vault and the appropriate header is constructed at execution time.

How do I invite a candidate to a test through the API?

POST /x/api/v3/tests/{test_id}/candidates with the candidate's email and full_name. The response returns the candidate id, which you can then pass to /x/api/v3/tests/{test_id}/candidates/{candidate_id}/invite to send the invitation email and obtain the unique test URL.

Can I download the candidate's score report as a PDF?

Yes. GET /x/api/v3/tests/{test_id}/candidates/{candidate_id}/pdf returns the candidate's full score report including per-question outcome and overall score. Useful for archiving in the ATS once the candidate completes the assessment.

How do I schedule a pair-coding interview with the API?

POST /x/api/v3/interviews with the candidate details, template id, and start time. The response includes the interview URL that both candidate and interviewer use to enter the pad. Update later with PATCH on /x/api/v3/interviews/{interview_id}.

What rate limits apply to the HackerRank for Work API?

HackerRank enforces per-account rate limits that vary by plan. The API returns 429 with a Retry-After header when exceeded. For nightly score syncs, batch the work over off-peak hours and respect the header rather than retrying tightly.

How do I integrate HackerRank with AI agents through Jentic?

Run pip install jentic, then search 'invite candidate to a hackerrank test'. Jentic returns the POST /x/api/v3/tests/{test_id}/candidates operation. Load and execute it with email and full_name to enrol the candidate. Sign up at https://app.jentic.com/sign-up to obtain an agent key.

Can I read the question bank through the API?

Yes. GET /x/api/v3/questions lists questions in the bank, and GET /x/api/v3/questions/{question_id} returns the full question detail. Useful for keeping an external curriculum doc in sync with the active question pool.

HackerRank for Work API

Connect the HackerRank for Work API to your agent

Capabilities

Start building with HackerRank for Work API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs