Base URL: http://localhost:8080
Authenticate with Authorization: Bearer <token> on all protected endpoints.
| Method | Path | Auth | Description |
|---|---|---|---|
| POST | /v1/auth/token | — | Exchange API key for a 24h tenant JWT. |
| POST | /v1/auth/admin/login | — | Admin username/password → 8h admin JWT. |
| GET | /v1/me | Tenant JWT | Return current tenant profile. |
| GET | /v1/admin/me | Admin JWT | Return current admin profile. |
| Method | Path | Auth | Description |
|---|---|---|---|
| POST | /v1/transfers | Tenant JWT | Create a new transfer (initiates VASP discovery). |
| GET | /v1/transfers | JWT | List transfers (paginated). |
| GET | /v1/transfers/:id | JWT | Get transfer detail. |
| GET | /v1/transfers/:id/history | JWT | Status change audit trail. |
| PATCH | /v1/transfers/:id | Admin JWT | Update transfer (admin only). |
| DELETE | /v1/transfers/:id | Admin JWT | Soft-delete transfer. |
| Method | Path | Auth | Description |
|---|---|---|---|
| POST | /v1/transfers/:id/poo | JWT | Self-declaration PoO. |
| POST | /v1/transfers/:id/poo/challenge | JWT | Create EIP-191 signature challenge. |
| POST | /v1/transfers/:id/poo/signature | JWT | Submit signed challenge. |
| POST | /v1/transfers/:id/poo/satoshi | JWT | Create Satoshi test challenge. |
| GET | /v1/transfers/:id/poo/satoshi/:cid | JWT | Poll Satoshi challenge status. |
| POST | /v1/transfers/:id/poo/satoshi/:cid/verify | JWT | Submit tx hash for Satoshi verification. |
| POST | /v1/transfers/:id/poo/eid/session | JWT | Create eID session. |
| GET | /v1/transfers/:id/poo/eid/session/:sid | JWT | Poll eID session status. |
| GET | /v1/poo/verify | JWT | Check PoO status for an address (?address=&chain=). |
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /v1/vasps/search | JWT | Search VASP directory (?q=). |
| GET | /v1/addresses/lookup | JWT | Lookup address (?network=&address=). |
| POST | /v1/addresses/classify | JWT | Classify an address (custodial vs self-hosted). |
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /v1/dashboard/transactions | JWT | Paginated compliance transaction list. |
| GET | /v1/dashboard/transactions/export | JWT | Download CSV of all transactions. |
| GET | /v1/dashboard/transactions/:id | JWT | Transfer detail for dashboard. |
| GET | /v1/dashboard/addresses | JWT | Paginated address registry. |
| GET | /v1/dashboard/addresses/export | JWT | Download CSV of all addresses. |
| GET | /v1/dashboard/addresses/:id | JWT | Address detail. |