biotech

Validate an NCT number's format and existence

Validates an NCT number's format (locally) and, by default, confirms it exists in ClinicalTrials.gov. confidence 1.0 = valid format and (if checked) exists; 0.0 = malformed NCT or no such trial. exists is null whenever CT.gov was NOT consulted (verify_exists false, or a format reject) and false only as a confirmed registry negative. Set verify_exists false for a cheap format-only check (no upstream, 1 cost_unit). With verify_exists true an outage returns 503. Charges 2 cost_units when CT.gov is consulted; 1 for the format-only mode or when the NCT fails the local format check (CT.gov never called).

post/v1/biotech/trial/validate

Request

  • Base URL: https://api.snipget.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.snipget.ai/v1/biotech/trial/validate
  • Auth: none declared

Query parameters

include_receiptboolean

Set true to attach an execution receipt at meta.receipt — caller-verifiable sha256 hashes over the RFC 8785 (JCS) canonicalization of this call's as-received JSON body and its result (free, like include_trace). Reproduce with any JCS library: input_hash = sha256(jcs({"tool": <request path>, "args": <your body minus include_trace/include_receipt>})); result_hash = sha256(jcs(result)). For deterministic tools, same input on the same build reproduces result_hash.

Headers

authorizationstring nullable
X-API-Keystring nullable

Request body

nct_idstring required

The NCT number to validate (e.g. 'NCT02967757').

verify_existsboolean

If true (default), confirm the trial exists in ClinicalTrials.gov (2 cost_units). If false, check only the NCT format locally — no upstream call (1 cost_unit).

include_traceboolean

Response

Successful Response

statusstring
confidencenumber required

Changes

No recorded changes to this operation across all 1 revision of this API.