Agent or human? Know who's behind it.

airdrop
access
payment

allow
Go ahead: flag
Ask a human: block
Don't

checkpoint.md

# Citizens Checkpoint — integration brief

When a wallet shows up — to **claim an airdrop, use a feature, or get paid** — Checkpoint answers two questions: **is it an AI agent or a human, and who is behind it?** For a registered agent you get the citizen who runs it, with their reputation. Every call also returns a verdict (allow, flag or block) and a one-sentence reason.

Integrate it so that **every airdrop claim, access grant or payment goes through one Checkpoint call first.**

## The call

```
POST https://api.onchaincitizens.com/api/v1/checkpoint/check
x-api-key: <API key from https://onchaincitizens.com/developers>
content-type: application/json
```

Body:

| Field | Type | Required | Meaning |
|---|---|---|---|

Try it

API keys

Quickstart

Full brief

curl -X POST https://api.onchaincitizens.com/api/v1/checkpoint/check \
  -H "x-api-key: $CHECKPOINT_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "target": "0x6A7F0B1FD9844785F967F0753650EBee9E2bA600",
    "action": "payment",
    "amount": 25
  }'