Skip to main content
GET
/
v1
/
truth
/
claims
/
{claimId}
/
status
Get Claim Status
curl --request GET \
  --url https://api.truthlocks.com/v1/truth/claims/{claimId}/status \
  --header 'X-API-Key: <api-key>'
{
  "claim_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "claim_type": "<string>",
  "payload": {},
  "evidence": [
    {}
  ],
  "status": "pending",
  "receipt_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attestations": [
    {
      "attestation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "witness_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "claim_hash": "<string>",
      "signature": "<string>",
      "status": "pending",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "verified_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z"
}
Returns the full details of a truth claim including its current lifecycle status, the original assertion, and — if verification is complete — the verification result and associated receipt. Use this endpoint to check whether a claim has been verified, disputed, or rejected.

​
Authentication

Requires X-API-Key header or Bearer JWT token. Tenant-scoped via X-Tenant-ID.

​
Path Parameters

​
id
string
required
The unique identifier of the truth claim. Format: maip-tc:ULID.

​
Response

​
id
string
The truth claim identifier.
​
agent_id
string
The agent that created the claim.
​
claim_type
string
Classification of the claim (identity, integrity, provenance, compliance, capability).
​
subject
string
The entity or resource the claim is about.
​
assertion
string
The assertion being made.
​
status
string
Current lifecycle status. One of: pending, verifying, verified, disputed, rejected.
​
confidence
number
The original agent’s self-reported confidence in the assertion.
​
evidence_urls
string[]
URLs pointing to supporting evidence submitted with the claim.
​
metadata
object
Arbitrary key-value metadata attached to the claim.
​
verification_result
object
Present only when verification is complete. Contains the determination details.
​
receipt_id
string
The receipt identifier minted when the claim reached a terminal state. null if still pending or verifying.
​
created_at
string
ISO 8601 timestamp of when the claim was created.
​
updated_at
string
ISO 8601 timestamp of the last status change.

Authorizations

​
X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

​
claimId
string<uuid>
required

Claim identifier

Response

Claim status

​
claim_id
string<uuid>
​
agent_id
string<uuid>
​
claim_type
string
​
payload
object
​
evidence
object[]
​
status
enum<string>
Available options:
pending,
verified,
rejected,
expired
​
receipt_id
string<uuid>
​
attestations
object[]
​
verified_at
string<date-time>
​
created_at
string<date-time>