---
title: "Verify a business before acting; with an activity, get a decision and a signed receipt"
method: GET
path: "/v1/entities/{id}/verify"
tags: ["verify"]
---

# Verify a business before acting; with an activity, get a decision and a signed receipt

`GET /v1/entities/{id}/verify`

## Request

- Base URL: `https://jid.com`
- URL: `https://jid.com/v1/entities/{id}/verify`
- Auth: one of:
  - none
  - HTTP bearer

One check. Without activity, jurisdiction or amount: status, flags and every current fact with its receipts (unchanged since 1.0). With any of them: also `decision` (proceed | review | stop | insufficient_data) with reasons, and `receipt` (stored 13 months, Ed25519-signed). Act only on proceed; requirements Jid cannot check are unknown and lead to review.

## Path parameters

- `id` string, required

## Query parameters

- `activity` 'general_commerce' | 'sell_prescription_drugs' | 'manufacture_drugs' | 'sell_medical_devices' | 'haul_freight' | 'broker_freight' | 'sell_alcohol' | 'produce_spirits' | 'provide_investment_advice' | 'accept_deposits' | 'lend' | 'bill_medicare_medicaid' | 'healthcare_supplier' | 'federal_contracting' | 'charitable_solicitation' | 'construction' | 'operate_psilocybin_healing_center'
- `jurisdiction` string
- `amount` number
- `currency` string

## Response `200`

The file, and the decision when requested

- VerifyResponse
  - `id` string
  - `name` string
  - `url` string
  - `file_checked_at` string
  - `owner_status` string
  - `status` object
    - `status` 'active' | 'attention' | 'inactive' | 'unknown'
    - `summary` string
    - `flags` object[]
    - `rules_version` string
  - `identifiers` object[]
    - `type` string
    - `value` string
    - `source` string
  - `facts` Fact[]
    - `predicate` string
    - `label` string
    - `value` unknown
    - `source` object
      - `id` string
      - `name` string
      - `agency` string, nullable
    - `source_url` string, nullable
    - `observed_at` string, nullable
    - `verified_at` string, date-time
    - `next_check_at` string, date-time
    - `confidence` 'high' | 'medium' | 'low'
    - `snapshot_sha256` string, nullable
  - `not_in_sources` string[]
  - `terms` string
  - `decision` Decision
    - `decision` 'proceed' | 'review' | 'stop' | 'insufficient_data'
    - `activity` 'general_commerce' | 'sell_prescription_drugs' | 'manufacture_drugs' | 'sell_medical_devices' | 'haul_freight' | 'broker_freight' | 'sell_alcohol' | 'produce_spirits' | 'provide_investment_advice' | 'accept_deposits' | 'lend' | 'bill_medicare_medicaid' | 'healthcare_supplier' | 'federal_contracting' | 'charitable_solicitation' | 'construction' | 'operate_psilocybin_healing_center'
    - `jurisdiction` string, nullable
    - `amount` number, nullable
    - `currency` string, nullable
    - `reasons` Reason[]
      - `code` string, required
      - `requirement` string, required
      - `kind` 'registration' | 'flag' | 'unheld'
      - `met` union, required
        - boolean
        - 'unknown'
      - `effect` 'stop' | 'review' | 'null', nullable
      - `detail` string
      - `fact_ids` string[], required
      - `source` object, nullable
        - `id` string
        - `name` string
        - `agency` string
      - `source_url` string, nullable
      - `verified_at` string, date-time, nullable
      - `fresh_until` string, date-time, nullable
      - `authority` string
    - `notes` string[]
    - `rules_version` string
    - `rules_url` string
    - `not_legal_advice` string
    - `receipt_id` string
  - `receipt` Receipt
    - `receipt_id` string
    - `url` string
    - `statement` object: Exactly what was signed: type, version, receipt_id, issued_at, issuer, entity, inputs, decision, rules_version, reasons (code, met, effect, fact_ids, source, verified_at, fresh_until), facts (id, predicate, source, value_sha256, verified_at), terms.
    - `signature` object
      - `alg` 'Ed25519'
      - `kid` string
      - `canonicalization` 'sorted-keys-json'
      - `sig` string: base64url
    - `verify` string

## Other responses

- `400`: Error
- `402`: Error
- `404`: Error
- `429`: Error

---

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