APIRAPIR · The evidence record for AI agents · Guide

What is an AI agent evidence record?

An AI agent evidence record is a history of what an AI agent did that someone outside your company can check without trusting you. It has three parts: signed papers that say whose agent it is, a mandate that says what it may and may never do, and a log book in which every entry is chained to the one before it, so a changed or deleted entry shows. APIR keeps that record: papers signed with Ed25519 under did:web:apir.ai, an insert-only SHA-256 hash chain, and a timestamp on the chain every night from an outside RFC 3161 authority.

By APIR · updated

The problem

Why an ordinary log is not enough

An ordinary log is kept by the party it describes. The people who most need to read it are the ones with the least reason to trust it.

When an AI agent books a payment, answers a customer or changes a record, the only account of what happened is usually the vendor's own log. The vendor can edit it, lose it, or send a screenshot of the good parts. A buyer's security reviewer, an auditor or an insurer has no way to tell which.

An evidence record is built for that reader. It answers three questions with something they can check themselves: whose agent is this, what was it allowed to do, and what did it actually do.

The parts

What goes into an AI agent evidence record

Five parts, each one checkable on its own.

  • Signed papers (identity). A credential for the agent, signed with Ed25519. APIR publishes its public keys at /.well-known/jwks.json and its DID document under did:web:apir.ai, so a signature checks against a key anyone can fetch.
  • A mandate. What the agent may do and may never do, written by its owner. With a mandate on file, "did it stay inside its authority?" becomes a question with an answer, not an argument.
  • A log book (the Agent Black Box). Insert-only. Every entry carries a SHA-256 hash of its content and of the entry before it. Change one entry and every hash after it stops matching.
  • An outside timestamp. Every night the heads of the agents' chains are combined into one Merkle root that an outside RFC 3161 time-stamping authority stamps, so a later rewrite of anything before a stamp would no longer match it. For an agent with a public passport, anyone can fetch the token from the verify-black-box endpoint and check the stamp themselves, and an owner's free export carries the tokens too. The passport, the check, the resolve answer and the Evidence Pack do not carry them yet.
  • A Trust Passport and an Evidence Pack. The passport is the agent's public, signed summary, graded from its record; an agent with no evidence is shown as Unrated, never given a made-up score. The Evidence Pack seals one agent's record for a deal, a security review or a claim, behind a public link.
Checking it

How someone checks the record

No account, no login, no call to the vendor.

Paste an agent's name or passport ID at apir.ai/check-agent. APIR re-checks the Ed25519 signature against the published key, reads the mandate back and counts the log book's events. Open the agent's passport from there, or at verify a passport, and the log book is recomputed from what is stored: every link, every hash, every sequence number. Agents whose owners listed them publicly are in the registry. The signature also checks offline, against the JWKS file, with no APIR server involved.

AI assistants can run the same check. APIR's read-only MCP server, listed in the official MCP registry as ai.apir/verify, answers "is this agent who it claims, what mandate is on file for it, and what is its record?" at https://apir.ai/api/mcp. Every answer is as of the moment it is asked.

Honest limits

What an evidence record proves, and what it does not

It proves the record is intact and dated. It never proves the agent was right.

  • It proves the papers were signed by the key published under did:web:apir.ai, and that the log book has not been changed since each entry was written.
  • For an agent that runs outside APIR, the log book proves what the agent reported and shows any later change to it. It does not prove the report was complete.
  • The mandate is written by the agent's owner. The record shows what the agent did beside the mandate on file at the time, so anyone can compare the two. It does not show whether the mandate was wise, or prove a permission still held at the moment an action ran.
  • A passport reflects the agent's state as of its last assessment, and says when that was.

We don't promise results. We prove whatever happens.

Who asks for one

Who asks for an AI agent evidence record

Anyone who has to rely on an agent they did not build.

  • Buyers. Security reviews now ask how an AI agent is controlled and what it did. A record they can verify ends the back-and-forth faster than another questionnaire answer.
  • Insurers. AI insurers price from the system in front of them. The record shows them its history instead of a description of it.
  • Auditors. A log they can recompute themselves, with timestamps from an authority the vendor does not control.
  • Australian organisations. From 10 December 2026 the Privacy Act asks privacy policies to describe automated decisions that significantly affect people. See what the OAIC says.
Answers

Questions people ask

What is an AI agent evidence record?

A history of what an AI agent did that someone outside your company can check without trusting you: signed papers saying whose agent it is, a mandate saying what it may do, and a hash-chained log book whose entries cannot be changed without it showing. APIR keeps one for each agent, signed with Ed25519 under did:web:apir.ai and timestamped nightly by an outside RFC 3161 authority.

How is an evidence record different from observability logs?

Observability logs and traces are kept by the team that runs the agent, for that team, to debug and improve it. An evidence record is kept for a reader outside the team: it is signed, insert-only, hash-chained and timestamped by an outside authority, so a buyer, auditor or insurer can check it without access to your tools and without trusting you.

What is a tamper-evident log for AI agents?

A log where any change to a past entry is detectable. In APIR's Agent Black Box every entry carries a SHA-256 hash of its content and of the entry before it, and the head of the chain is timestamped every night by an outside RFC 3161 authority. Edit or delete an entry and the hashes after it stop matching. Tamper-evident means a change shows, not that a change is impossible.

What is an AI agent passport?

A signed credential for an AI agent. APIR's Trust Passport is an Ed25519-signed credential that binds the agent to its grade and its record. It can be fetched in the W3C Verifiable Credential shape, with APIR's own proof scheme rather than a registered VC 2.0 suite. Anyone checks a public passport at apir.ai/check-agent or apir.ai/verify-passport, or offline against the keys at apir.ai/.well-known/jwks.json, following the specification at apir.ai/agent-record-specification.

Can someone check an APIR record without an account?

Yes. The check at apir.ai/check-agent is free, needs no account, and is never paywalled. A public passport's signature can also be checked offline against the published key, following the specification at apir.ai/agent-record-specification. The signed bytes include the owner's organisation ID, which the owner gives you, not APIR.

Does APIR see my agent's prompts?

Not for an agent that runs outside APIR. Prompts and outputs stay on your side and only their SHA-256 hashes are sent to the log book, through POST https://apir.ai/api/v1/events.

Sources

Sources

  1. APIR DID document (did:web:apir.ai)
    https://apir.ai/.well-known/did.json
  2. APIR public signing keys (JWKS)
    https://apir.ai/.well-known/jwks.json
  3. Check an AI agent, free
    https://apir.ai/check-agent
  4. The public registry
    https://apir.ai/registry
  5. APIR Trust Center
    https://apir.ai/trust
  6. APIR in the MCP registry (ai.apir/verify)
    https://registry.modelcontextprotocol.io/v0/servers/ai.apir%2Fverify/versions/latest
  7. RFC 3161, Time-Stamp Protocol
    https://www.rfc-editor.org/rfc/rfc3161
  8. did:web method specification
    https://w3c-ccg.github.io/did-method-web/
APIR
Don't take this page's word for it.

Check a live agent's papers and log book yourself, free and with no account.

AI Disclosure:APIR uses AI systems (Claude by Anthropic) for SENTINEL, assessment drafting, regulatory monitoring, and company enrichment. AI-generated outputs are labelled as such.

Limitations: AI outputs may not always be accurate, may generate incorrect or inaccurate content, and can hallucinate. They are provided for informational purposes only and are not a substitute for qualified human review. AI outputs should not be relied upon for legal, financial, or regulatory decisions without human verification. See our Model Card & system documentation, Responsible AI / AI Ethics Policy, and GDPR Article 22 disclosure for automated decisions, profiling, and right-to-human-review details.