Sign in

v3

latestOpenAPI 3.0.32026-08-05363479.3 KB

Record caller-attested principal interest in one controlled next step

Creates a private, query-free Stage 1 demand receipt bound to an exact returned organic domain. It expires with the source search, no later than 30 days after that search. It does not contact the provider, create an action ticket or charge, affect organic rank or readiness score, or count as commercial proof. The caller attests current principal interest under the exact wording at https://nothumansearch.ai/privacy#action-interest-v1; NHS does not verify identity, agency, or legal authority.

post/action-interests

Request body

search_idstring required

Committed query-free organic search receipt

domainstring required

Bare domain present in the referenced organic results; schemes

action_type'quote' | 'trial' | 'demo' | 'booking' | 'application' | 'signup' | 'purchase' required
caller_attests_principal_interesttrue required

Caller attests current human/company principal interest; this is not authority to contact the provider

confirmation_version'nhs-action-interest-v1' required

Response

Exact idempotent replay of the existing receipt

createdboolean required
idempotent_replayboolean required
provider_contactedfalse required
row_level_shared_with_providerfalse required
action_ticket_createdfalse required
charge_createdfalse required
provider_or_principal_chargedfalse required
commercial_prooffalse required
organic_rank_affectedfalse required
rank_or_score_inputfalse required
retention_days30 required
evidence_scopestring required