---
title: "Screen an address across configured compliance providers"
method: POST
path: "/v1/compliance/address-screenings"
tags: ["Compliance"]
---

# Screen an address across configured compliance providers

`POST /v1/compliance/address-screenings`

Runs address screening against configured compliance providers and returns provider-level risk scores.

## Headers

- `x-project-id` string — Selects the active project for this request. Required for session/dashboard callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

## Request body

- object — Address compliance screening request payload.
  - `address` string, required — Address to screen.
  - `network` string — Network identifier expected by the compliance provider.
  - `intent` 'transfer_destination' | 'wallet_address_addition' | 'unknown' — Business intent for address screening.

## Response `200`

Address screening results

- object — Standard success response envelope.
  - `data` object, required — Address screening response payload.
    - `screening` object, required — Aggregated address screening response.
      - `address` string, required — Address that was screened.
      - `network` string, required — Network that was screened.
      - `intent` 'transfer_destination' | 'wallet_address_addition' | 'unknown', required — Business intent for address screening.
      - `checkedAt` string, date-time, required — Timestamp when all provider checks completed.
      - `providers` object[], required
        - `provider` 'range' | 'elliptic' | 'trm' | 'chainalysis', required — Compliance provider identifier.
        - `status` 'ok' | 'unavailable' | 'error', required — Provider response status.
        - `riskScore` number, nullable, required — Risk score returned by the provider.
        - `riskLevel` string — Provider-specific risk level label.
        - `message` string — Optional provider message, such as warnings or error details.
        - `evaluatedAt` string, date-time, required — Timestamp when the provider result was produced.
  - `meta` object, required — Response metadata.
    - `requestId` string, required — Request identifier for tracing.
    - `timestamp` string, date-time, required — ISO 8601 timestamp.

## Other responses

- `400` — Error
- `401` — Error
- `403` — Error
- `500` — Error

## Changes

- **2026-08-15** `3e302bba5386` — 4 warning
  - added the new `SERVICE_UNAVAILABLE` enum value to the `error/code` response property for the response status `400`
  - added the new `SERVICE_UNAVAILABLE` enum value to the `error/code` response property for the response status `401`
  - added the new `SERVICE_UNAVAILABLE` enum value to the `error/code` response property for the response status `403`
  - added the new `SERVICE_UNAVAILABLE` enum value to the `error/code` response property for the response status `500`

[Change history](https://skmtc.dev/solana/apis/solana-developer-platform-api/changes/v1/compliance/address-screenings/post.md)

---

[API](https://skmtc.dev/solana/apis/solana-developer-platform-api.md) · [All operations](https://skmtc.dev/solana/apis/solana-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/solana/solana-developer-platform-api/revisions/aedc48d5b49e/schema)