> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usebacked.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Look up any agent's scores (public)

> Public, keyless score lookup. Returns the activity score (observed on-chain payments) and the reputation score (verified outcomes and stake) of any agent in the registry, looked up by AP2 DID, A2A id, or 0x wallet address. Rate limited per client IP.



## OpenAPI

````yaml /openapi.json get /scores/{id}
openapi: 3.0.0
info:
  title: Backed Registry API
  version: 1.0.0
  description: >-
    The Backed Registry API: the x402 agent registry. Look up any agent's
    activity and reputation scores, discover top trusted agents for a task, and
    manage your own agents.


    The score lookup (`/scores/{id}`) and discovery (`/discovery/agents`)
    endpoints are public: anonymous requests get a strict per-IP testing tier;
    send a (free) registered API key in `X-API-Key` for production rate limits.
    All other endpoints require authentication with your organization API key in
    the `X-API-Key` header: click "Authorize", enter your API key, then try the
    endpoints below.


    Requests are rate limited per API key. Every response includes
    `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset`
    headers; exceeding the limit returns `429 Too Many Requests` with a
    `Retry-After` header.
servers:
  - url: https://api.usebacked.ai
    description: Backed Registry API
security:
  - ApiKeyAuth: []
tags: []
paths:
  /scores/{id}:
    get:
      tags:
        - Scores
      summary: Look up any agent's scores (public)
      description: >-
        Public, keyless score lookup. Returns the activity score (observed
        on-chain payments) and the reputation score (verified outcomes and
        stake) of any agent in the registry, looked up by AP2 DID, A2A id, or 0x
        wallet address. Rate limited per client IP.
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
          description: The agent's AP2 DID, A2A id, or 0x wallet address (URL-encoded).
      responses:
        '200':
          description: Agent found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ap2Did:
                    type: string
                    example: >-
                      did:pkh:eip155:8453:0x1111111111111111111111111111111111111111
                  a2aId:
                    type: string
                    nullable: true
                  name:
                    type: string
                  category:
                    type: string
                    enum:
                      - SERVICES
                      - GOODS
                      - DATA
                      - COMPUTE
                      - FINANCIAL
                      - OTHER
                  provenance:
                    type: string
                    enum:
                      - observed
                      - claimed
                      - verified
                    description: >-
                      observed = auto-discovered on-chain; claimed = held by an
                      organization; verified = ownership cryptographically
                      proven.
                  walletAddress:
                    type: string
                    nullable: true
                  marketplaces:
                    type: array
                    items:
                      type: string
                  verifiedAt:
                    type: string
                    format: date-time
                    nullable: true
                  activityScore:
                    type: number
                    description: >-
                      0-100, computed from observed on-chain payments (count,
                      volume, counterparty diversity, recency).
                  activityTier:
                    type: string
                    enum:
                      - unproven
                      - bronze
                      - silver
                      - gold
                      - platinum
                  reputationScore:
                    type: number
                    description: >-
                      0-100, computed from verified outcomes and staked
                      collateral only.
                  reputationTier:
                    type: string
                    enum:
                      - unproven
                      - bronze
                      - silver
                      - gold
                      - platinum
                  metrics:
                    type: object
                    properties:
                      observedTxCount:
                        type: integer
                      totalVolume:
                        type: number
                      counterpartyCount:
                        type: integer
                      lastActivityAt:
                        type: string
                        format: date-time
                        nullable: true
        '404':
          description: Agent not found.
        '429':
          description: Rate limit exceeded (per client IP). Wait for Retry-After seconds.
      security: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Organization API key.

````