The verification endpoint is a public REST endpoint that returns the declared identity and current status of any published AIP agent. No authentication required.

Endpoint

GET https://app.gazebohq.com/api/v1/agents/verify/:id

Parameter	Description
:id	The agent's AIP slug (e.g. stripe-payment-monitor)

Response

{
  "id": "stripe-payment-monitor",
  "name": "Stripe Payment Monitor",
  "status": "active",
  "version": "1.0.0",
  "scope": [
    { "service": "stripe", "actions": ["payments:read", "charges:list"] },
    { "service": "github", "actions": ["issues:write"] }
  ],
  "author": {
    "name": "Alice Chen",
    "url": "https://example.com/agents/alice"
  },
  "install_count": 1847,
  "published_at": "2026-07-27T00:00:00Z",
  "last_verified_at": "2026-07-27T12:00:00Z"
}

Status values

Status	Meaning
active	Agent is published and accepting installs
deprecated	Superseded by a newer version; existing installs still function
revoked	Removed by the author or Gazebo; all installs are deactivated

Error responses

HTTP status	Meaning
404 Not Found	No published agent exists with this ID

Usage

The verification endpoint is intended for:

• Marketplaces and directories — checking agent status before listing
• Tooling — programmatically verifying an agent's scope before install
• Auditors — confirming what scope was declared at a given version

The identity stamp links to a human-readable version of this data at gazebohq.com/agents/verify/:id.