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.
Question types and AI prompts
Use hackerrank.types.QuestionType for known API question types. The clients continue to accept strings, and Question.type preserves unknown response values so newer server types remain readable. QuestionType.supports_custom_system_prompt and Question.supports_custom_system_prompt report known prompt support.
Typed and generic question writes reject prompts longer than 15,000 characters and prompts supplied for known unsupported types before sending a request. Generic partial updates can omit the type. The server then decides whether the field applies. No supplied prompt is silently removed from an invalid request.
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.10.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| hackerrank-2026.11.10.4.tar.gz | 208.1 kB | With provenance | Details for hackerrank-2026.11.10.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| hackerrank-2026.11.10.4-py3-none-any.whl | Python 3 | none | any | Details for hackerrank-2026.11.10.4-py3-none-any.whl |
Total release size: 304.6 kB
Release files / hackerrank-2026.11.10.4.tar.gz
| Download URL | hackerrank-2026.11.10.4.tar.gz |
|---|---|
| Size | 208.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bbfb66dbab862c7d6610c308fffcb36fc5e4d933f90ccdb62904bfd6d3edf3fe
|
|
BLAKE2b-256 checksum How to use checksums |
c4667470f17b80d3cbeae8fe66b181fb966fcec1e2c8e0faf590579390d6786a
|
| 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 10, 2026.
Transparency logRelease files / hackerrank-2026.11.10.4-py3-none-any.whl
| Download URL | hackerrank-2026.11.10.4-py3-none-any.whl |
|---|---|
| Size | 96.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d5faadc4f517c71aa1d1468e7493bdcc2e4960b2bc32c63628e05f8153daec4e
|
|
BLAKE2b-256 checksum How to use checksums |
4a1b8442056aa7d1a8f34ad2b223417024264df95c7774aa3aa5404e6e46de65
|
| 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 10, 2026.
Transparency logSecurity for hackerrank 2026.11.10.4
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.
Attestation for hackerrank-2026.11.10.4.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 10, 2026.
Transparency logA 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.