TrustWiz
Register Gap
API Reference v1.0

Developer Documentation.

Integrate the TrustWiz Intelligence Registry directly into your application. Our REST API allows programmatic verification of candidate career gaps with sub-second latency and absolute DPDP compliance.

Authentication

The TrustWiz API uses API keys to authenticate requests. You can request an enterprise API key by contacting our B2B integration team. Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth.

Authentication to the API is performed via the custom X-API-Key HTTP header.

Security Notice All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

Verify a Ledger Node

Retrieves the verification status of a specific candidate Trust-ID. This endpoint is designed to be queried automatically by your ATS when a candidate submits their application.

GET https://api.trustwiz.co.in/api/v1/verify.php

Query Parameters

Parameter Description
trust_id Required The unique cryptographic identifier minted by TrustWiz (e.g., TW-2026-AB-12345). Must be exact match.

HTTP Status Codes

TrustWiz uses conventional HTTP response codes to indicate the success or failure of an API request.

200 OK - Everything worked as expected. Trust-ID is verified.
400 Bad Request - Missing the trust_id parameter.
401 Unauthorized - Missing or invalid API key.
403 Forbidden - The API key has been revoked.
404 Not Found - The Trust-ID does not exist or is marked as REJECTED.
Example Request (cURL)
curl -X GET https://api.trustwiz.co.in/api/v1/verify.php?trust_id=TW-2026-AB-12345 \
  -H "X-API-Key: tw_live_ent_8a9b..."
Response: 200 OK
{
  "status": "success",
  "data": {
    "trust_id": "TW-2026-AB-12345",
    "candidate_name": "Aditya Sharma",
    "protocol_module": "MOD-01 Corporate Restructuring",
    "audited_duration": "14 Months",
    "verification_timestamp": "2026-03-24T14:30:00Z",
    "dpdp_purged": true,
    "authenticity": "VERIFIED"
  },
  "meta": {
    "queried_by": "Workday ATS Production",
    "server_timestamp": "2026-03-24T18:55:00Z"
  }
}
Response: 404 NOT FOUND
{
  "status": "not_found",
  "message": "NODE UNVERIFIED: No authentic clearance record found for this Trust-ID."
}