Skip to content

Managing your Partner Profile

Retrieve and update the profile attached to your Partner API key.

Partners can retrieve and update their own profile with the Partner API key. Both endpoints use the X-Partner-Api-Key header.

Get Partner Profile

GET /partners/me returns the profile configured for the authenticated partner.

curl --location 'https://api-dev.cryptoswift.eu/partners/me' \
  --header 'X-Partner-Api-Key: <partner-api-key>'
{
  "name": "PartnerName",
  "email": "ops@partner.domain",
  "country": "Estonia",
  "webpage": "https://partner.domain",
  "legalName": "Partner Legal Name OU",
  "webhookUrl": "https://partner.domain/webhooks/cryptoswift",
  "webhookSecret": "generated-webhook-secret"
}

Update Partner Profile

PATCH /partners/me updates one or more modifiable profile fields. A successful update returns 200; call GET /partners/me to confirm the saved values and retrieve the current webhook secret.

Modifiable fields:

FieldDescription
emailPartner operations or support email.
countryPartner country.
webpagePublic partner website.
legalNameRegistered legal entity name.
webhookUrlPartner webhook endpoint for Travel Rule network updates.
curl --location --request PATCH 'https://api-dev.cryptoswift.eu/partners/me' \
  --header 'X-Partner-Api-Key: <partner-api-key>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "email": "ops@partner.domain",
    "legalName": "Partner Legal Name OU",
    "webpage": "https://partner.domain",
    "webhookUrl": "https://partner.domain/webhooks/cryptoswift"
  }'
Critical: webhookSecret rotation

Patching webhookUrl automatically generates a new webhookSecret. Immediately call GET /partners/me after updating the webhook URL, then sync and save the new secret before processing Partner webhooks.

webhookUrl and webhookSecret are used for Travel Rule Network partners. Reseller partners typically receive notifications at the tenant/client level instead.