Verification

Verify Ed25519 receipt signature (REST)

Public endpoint. Accepts a signed market receipt and verifies the Ed25519 signature in-worker. Returns validity, expiry status, and reason. Offline verification via @headlessoracle/verify is also supported and MAY be preferred by agents that don't need a REST round-trip.

post/v5/verify

Request

  • Base URL: https://headlessoracle.com
  • URL: https://headlessoracle.com/v5/verify
  • Auth: none declared

Request body

receiptobject required

Complete signed receipt as returned by /v5/status or /v5/demo.

Response

Verification result

validboolean
expiredboolean
reason'SIGNATURE_VALID' | 'INVALID_SIGNATURE' | 'MALFORMED_RECEIPT' | 'ORACLE_NOT_CONFIGURED' | 'RECEIPT_EXPIRED — re-fetch required' | 'CHECKS_FAILED'

Signature and expiry outcome. CHECKS_FAILED: the signature verifies and the receipt is unexpired, but another check in checks failed; valid is false.

micstring nullable
statusstring nullable
expires_atstring date-time nullable
checksobject

Per-check breakdown: each member is { passed, detail }.

receipt_summaryobject nullable

Changes

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