---
title: "Get behavioral trust score for an agent (query-param style)"
method: GET
path: "/v1/trust/score"
tags: ["trust"]
---

# Get behavioral trust score for an agent (query-param style)

`GET /v1/trust/score`

## Request

- Base URL: `https://agentlair.dev`
- URL: `https://agentlair.dev/v1/trust/score`
- Auth: one of:
  - HTTP bearer
  - none

Returns the behavioral trust score, tier, and component breakdown for the specified agent. Accepts agent_id as a query parameter. No auth required — anonymous callers pay 0.01 USDC via x402; authenticated callers use their API key.

## Query parameters

- `agent_id` string, required

## Response `200`

Trust score

- object
  - `agentId` string, required
  - `score` integer, required: Composite trust score (0-1000)
  - `tier` 'untrusted' | 'provisional' | 'trusted' | 'verified', required
  - `breakdown` object, required
    - `consistency` number: Behavioral consistency score component
    - `longevity` number: Account longevity score component
    - `transparency` number: Transparency score component
    - `volume` number: Activity volume score component

## Other responses

- `400`: Invalid agent ID
- `402`: Payment required (anonymous access — pay 0.01 USDC via x402). The same payment authorizes all three trust-query routes: /v1/trust/{agentId}, /v1/trust/{agentId}/check, /v1/trust/score — `resource` is the broader product URL (/v1/trust) by design.
- `503`: Trust scoring database not available

---

[API](https://skmtc.dev/agentlair/apis/agentlair-api.md) · [All operations](https://skmtc.dev/agentlair/apis/agentlair-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentlair/apis/agentlair-api/revisions/fac95ff4995d?raw)
