---
title: "Compliance check"
method: POST
path: "/compliance/check"
tags: ["Compliance"]
---

# Compliance check

`POST /compliance/check`

## Request

- Base URL: `https://app.arkova.ai/api/v1`
- URL: `https://app.arkova.ai/api/v1/compliance/check`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`
  - none

Check an entity against SEC filings, Federal Register regulatory actions, and public attestations for a heuristic compliance risk score. x402 payment gate.

## Request body

- object
  - `entity_name` string, required
  - `entity_type` 'individual' | 'organization'
  - `check_types` string[]
  - `jurisdiction` string

## Response `200`

Compliance check results with risk score

- object
  - `entity` object
    - `name` string
    - `type` 'individual' | 'organization'
    - `jurisdiction` string: Echoes the request jurisdiction; omitted when not supplied.
  - `compliance_status` 'clear' | 'review_required'
  - `risk_level` 'low' | 'medium' | 'high'
  - `total_findings` integer
  - `findings_by_severity` object
    - `critical` integer
    - `warning` integer
    - `info` integer
  - `findings` object[]
    - `category` 'sec_filing' | 'regulatory_action' | 'attestation'
    - `severity` 'info' | 'warning' | 'critical'
    - `source` string
    - `title` string
    - `date` string, date-time, nullable
    - `source_url` string, nullable
    - `anchor_status` string, nullable
  - `checked_at` string, date-time

## Other responses

- `400`: Invalid request
- `402`: Payment required (x402)

---

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