MegTrustDevelopers

Register a pending destination

POST/api/v1/counterparties

Authorization

KeyId Timestamp Signature
x-api-key-id<token>

Key ID registered by your organisation administrator.

In: header

x-api-timestamp<token>

Unix seconds within ±300 seconds of the server clock.

In: header

x-api-signature<token>

Padded base64 Ed25519 signature over timestamp, METHOD, exact path+query, lowercase SHA256(raw body), Idempotency-Key or empty string, joined with LF. Legacy HMAC uses lowercase hex HMAC-SHA256. Signing is required; entering a static value is insufficient.

In: header

Query Parameters

_request_id?string

Fresh random UUID per attempt, included in the signed path. Avoids duplicate signatures for identical requests in the same second.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Individual: first_name and last_name required. Company: company_name required. Hosted wallet: vasp_name required. Country must be a supported two-letter code. New entries are pending and require console verification.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/counterparties" \  -H "Content-Type: application/json" \  -d '{    "network": "string",    "address": "string",    "counterparty_type": "individual",    "wallet_type": "vasp",    "country": "st"  }'
{  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "label": "string",    "network": "string",    "network_name": "string",    "address": "string",    "direction": "string",    "status": "string",    "can_send": true,    "verified_at": "2019-08-24T14:15:22Z",    "counterparty_type": "string",    "first_name": "string",    "last_name": "string",    "company_name": "string",    "wallet_type": "string",    "vasp_name": "string",    "country": "string",    "created_at": "2019-08-24T14:15:22Z"  },  "meta": {    "count": 0,    "limit": 0,    "offset": 0,    "next_offset": 0,    "idempotent_replay": true,    "already_exists": true,    "stale": true  }}