Skip to main content

Build Status PyPI

hackerrank

Python library for the HackerRank for Work API.

Installation

pip install hackerrank

This is tested on Python 3.13+.

Getting Started

Generate an API token from the HackerRank for Work tokens page and pass it as api_key:

"""Example usage."""

import sys

from hackerrank.client import HackerRank

client = HackerRank(api_key="your-api-key")
for test in client.tests.list().data:
    _ = sys.stdout.write(test.name)
interview = client.interviews.create(title="My Interview")
_ = sys.stdout.write(interview.url)

Updating private notes

Use client.questions.update_internal_notes(question_id=..., internal_notes=...) to change private interviewer notes. The same operation is available on AsyncHackerRank. Every call reads the current required question fields and writes the requested notes, including identical or empty notes. The operation returns the question supplied by the update response, or None for an empty response. It raises ValueError if fields required by the update request are absent.

HTTPX2 transports

HTTPX remains the default client family. To opt in to HTTPX2, construct the HTTPX2 transport explicitly and pass it to the client. The standard hackerrank installation includes both client families.

"""Configure HackerRank to use HTTPX2."""

import httpx2

from hackerrank.client import HackerRank
from hackerrank.transports import HTTPX2Transport

transport = HTTPX2Transport(timeout=httpx2.Timeout(timeout=10))
with HackerRank(api_key="your-api-key", transport=transport) as client:
    tests = client.tests.list()

Use AsyncHTTPX2Transport with AsyncHackerRank for asynchronous calls. The timeout argument accepts an HTTPX2 timeout object or a number of seconds. Existing HTTPX users can keep their current configuration, but HTTPX2 transports require timeout objects from HTTPX2 when passing them across the package boundary. Migrating to HTTPX2 only requires selecting the new transport. HackerRank client methods and returned models are unchanged.

Full Documentation

See the full documentation.

Interviews V2 and audit logs

client.interviews.get_artifacts returns typed artifact metadata or an InterviewArtifactsPending result with the server’s retry delay. Signed download URLs expire. Request fresh metadata when needed. get_notes reads permitted interviewer notes and update_note replaces the current user’s note, preserving empty content.

Use client.audit_logs.list_cursor for large audit collections. Pass the returned next_cursor to continue. Subsequent requests send only that opaque token. Both audit methods support the documented filters, including user. The existing user_id argument sends the documented user query key. Offset pages expose the server’s window limit and exhaustion flag. All operations are also available on AsyncHackerRank.

Complete API operation catalogue

hackerrank.api.api_operations() lists every documented v3 and SCIM operation. client.api.call accepts the operation name, path parameters, query fields and complete JSON body, retaining the response status, headers and data. SCIM calls require their own scim_api_key and use the provisioning host. The same catalogue and execution interface are available asynchronously.

Metadata

Release files for hackerrank 2026.11.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hackerrank 2026.11.7
File Size Uploaded Provenance Actions
hackerrank-2026.11.7.tar.gz 188.2 kB With provenance Details for hackerrank-2026.11.7.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for hackerrank 2026.11.7
File Interpreter ABI Platform Actions
hackerrank-2026.11.7-py3-none-any.whl Python 3 none any Details for hackerrank-2026.11.7-py3-none-any.whl

Total release size: 276.5 kB

Release files / hackerrank-2026.11.7.tar.gz

Download URL hackerrank-2026.11.7.tar.gz
Size 188.2 kB
Tags Source
SHA-256 checksum
How to use checksums
b5950673b6f5e440138862793a0788ae299b0bc6387f980b3083c55a6c6f1c3e
BLAKE2b-256 checksum
How to use checksums
63a2930abf7c52ba20bb3223c8fc960cf145d808a0aff1a923538a1cca9b107f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Release files / hackerrank-2026.11.7-py3-none-any.whl

Download URL hackerrank-2026.11.7-py3-none-any.whl
Size 88.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0856d47e6596f26b28caa57ad48219785df6b9f3cc17e17b6b3371e65104c43f
BLAKE2b-256 checksum
How to use checksums
06e266741fff769fe3084c45b913fdd13a5d3d550651629a8528a955c75528ac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Security for hackerrank 2026.11.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for hackerrank-2026.11.7.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page