{"uid":"cap_3A4ZFQDU5NWe-7lMa_JmU","slug":"relayshield-agent-passport-issuance-d446694b","name":"RelayShield Agent Passport Issuance","description":"Identity security, threat monitoring and intelligence for the agentic AI era. TAP verifier for agentic commerce, MCP Proxy Firewall for AI agents, and threat intelligence APIs backed by 725K indicators across 129 monitored marketplaces.","url":"https://api.relayshield.net/v1/passport/issue?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"subject":{"type":"object","required":["agent_id"],"properties":{"did":{"type":"string","description":"Decentralized identifier, if the agent has one"},"wallet":{"type":"string","description":"Payment wallet address (EVM 0x... or Solana base58)"},"agent_id":{"type":"string","description":"Agent identifier in the presenting ecosystem"}},"description":"The agent the passport is about: agent_id plus a wallet or a did."},"screening":{"type":"object","properties":{"flags_total":{"type":"integer","description":"How many of those checks produced a threat flag"},"checks_total":{"type":"integer","description":"Total screening checks recorded for this identity"},"last_screened_at":{"type":"string","description":"Most recent screening time, ISO 8601 UTC"}},"description":"Asserted screening aggregates for the identity."},"verifications":{"type":"object","description":"Asserted TAP/PAP outcomes keyed by protocol (tap, pap): a status of verified, rejected or not_performed, verified_at required when verified, optional reference."}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"compact":"<base64url payload>.<base64url signature>","passport":{"issuer":"relayshield.net","subject":{"wallet":"0x1234567890abcdef1234567890abcdef12345678","agent_id":"agent_42"},"version":"1.0","issued_at":"2026-10-22T12:00:10Z","screening":{"flags_total":1,"checks_total":342,"last_screened_at":"2026-10-22T12:00:05Z"},"expires_at":"2026-11-21T12:00:10Z","passport_id":"rsp_9f8e7d6c5b4a39281706f5e4d3c2b1a0","signing_key":"11111111-2222-3333-4444-555555555555","verifications":{"tap":{"status":"verified","reference":"tap-verify-123","verified_at":"2026-10-22T12:00:00Z"}}},"status_url":"https://api.relayshield.net/v1/passport/rsp_9f8e7d6c5b4a39281706f5e4d3c2b1a0/status"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_a6lHc7dCtdLRDpQJWS8rT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Issues a signed, verifiable identity passport for an AI agent, embedding screening aggregates and TAP/PAP verification outcomes into a compact, portable credential.","exampleAgentPrompt":"Issue a RelayShield identity passport for agent ID 'agent_42' with wallet 0x1234567890abcdef1234567890abcdef12345678, TAP status verified as of now, and screening showing 342 total checks with 1 flag last run today.","exampleUseCases":[{"title":"Onboarding agent to agentic marketplace","prompt":"My agent 'commerce-bot-7' with wallet 0xAbCd...1234 just passed TAP verification — can you issue it a RelayShield passport so it can start transacting on agentic commerce platforms? It's had 500 screening checks with zero flags, last screened an hour ago."},{"title":"Credentialing agent after threat screening","prompt":"We just ran 200 identity checks on agent 'risk-agent-99' and flagged 3 issues. Issue it a RelayShield passport reflecting those screening results — TAP status is 'not_performed' — so downstream systems can see its current risk posture."},{"title":"Bootstrapping DID-linked agent identity","prompt":"Issue a signed passport for my agent 'did:key:z6Mk...abc' — it has agent ID 'autonomous-agent-1' and wallet 0xdeadbeef...0000. TAP was verified yesterday at noon, with 150 total screening checks and no flags, and I want a portable credential I can hand to partner APIs."}],"resultDescription":"Returns a JSON object containing a compact base64url-encoded signed passport (payload + signature), the full structured passport object with issuer, subject, issued_at, expires_at (30 days), screening aggregates, TAP/PAP verification details, a unique passport_id, and a status_url for future verification lookups.","failureModes":["Missing required agent_id returns a 400 validation error","Invalid wallet address format (non-EVM, non-Solana) causes rejection","TAP verifications with status 'verified' but missing verified_at timestamp fail schema validation","Payment not received or insufficient USDC triggers a 402 response","Malformed DID string may cause identity resolution failure","Screening timestamps in non-ISO 8601 format may cause parsing errors"],"whenToPreferThis":"Use this endpoint when an AI agent needs a portable, signed identity credential that bundles threat screening history and TAP/PAP verification status into a single verifiable passport — particularly before participating in agentic commerce, connecting to MCP-secured services, or proving trustworthiness to third-party APIs. Prefer this over generic identity tokens when the consumer specifically requires RelayShield-attested screening data or TAP compliance evidence.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:32:53.757Z","isFirstParty":false,"canonicalSlug":"relayshield-agent-passport-issuance-d446694b"}