---
title: "Public profile for a counterparty address."
method: GET
path: "/v1/addresses/{address}"
tags: ["Addresses"]
---

# Public profile for a counterparty address.

`GET /v1/addresses/{address}`

## Request

- Base URL: `https://api.fidren.net`
- URL: `https://api.fidren.net/v1/addresses/{address}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Public data only. The per-dimension scoring breakdown behind `trust_score` is not exposed here or anywhere else.

## Path parameters

- `address` string, required

## Query parameters

- `chain` 'base' | 'polygon'

## Response `200`

The public profile.

- AddressProfile
  - `address` string, required
  - `chain` string, required
  - `known` boolean, required: False when Fidren has never observed this address.
  - `trust_score` integer, required
  - `exposure_level` integer, required
  - `recommended_limit_cents` integer, required
  - `confidence` 'LOW' | 'MEDIUM' | 'HIGH', required
  - `observed_tenure_days` integer, required
  - `first_seen_at` string, date-time, nullable, required
  - `transaction_count` integer, required
  - `observed_volume_cents` integer, required
  - `counterparty_count` integer, required
  - `reported_outcomes` object, required
    - `completed_operations` integer, required
    - `reported_delivered` integer, required
    - `failed_operations` integer, required
    - `refunded_operations` integer, required
  - `disputes` object, required
    - `total` integer, required
    - `open` integer, required
  - `risk_signals` RiskSignal[], required
    - `code` string, required
    - `severity` 'INFO' | 'LOW' | 'MEDIUM' | 'HIGH', required
    - `detail` string, required
    - `value` number
    - `adverse` boolean, required: Whether the signal counts as evidence against the address. NO_HISTORY and NEW_ADDRESS are always false: unknown is not guilty.
  - `scoring_model_version` string, required
  - `evaluated_at` string, date-time, required

## Other responses

- `400`: The request was rejected by validation.
- `401`: No usable access path. Either a key was presented and is not valid, or no key was presented, the free allowance is spent, and x402 charging is off. A presented key never falls back to the free tier or to being charged.
- `403`: The API key is valid, but its organization is not currently permitted to make this request. Do not rotate the key: it is not the problem.
- `429`: Rate limit exceeded. Retry after the number of seconds in `Retry-After`.
- `503`: A required dependency is unavailable. Safe to retry.

---

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