Participants — Reference

Auth: X-API-Key on all routes.

POST /v1/participants — create

curl -X POST "$BASE_URL/v1/participants" \
  -H "X-API-Key: $THIQWAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "business",
    "legal_name": "Al Rashid Trading LLC",
    "email": "finance@alrashid.ae",
    "country": "AE",
    "verification_level": "standard",
    "tax_id": "TRN-100234567890003"
  }'

Field	Type	Required	Notes
type	enum	yes	business | individual
legal_name	string	yes	max 256
email	string	yes	unique per application
country	string	yes	ISO alpha-2
verification_level	enum	yes	standard | enhanced
tax_id	string	yes	max 64

Response 201 returns ParticipantResponseDto (id, kyb_status, country_name, timestamps). Errors: 400 VAL_0001, 409 duplicate email.

GET /v1/participants — list

Query: status · limit · cursor. Response: { "data": [...], "next_cursor": "…" | null }.

GET /v1/participants/:id — get

Errors: 404 (not found or not owned).

Deprecated alias

POST/GET /v1/counterparties[/:id] mirror these routes for backward compatibility. Migrate to /v1/participants.