Get a Sender

One Sender by id.

GET /api/v2/payouts/senders/{id}

Get a Sender

cURL

curl --request GET \
  --url https://api.mansa.xyz/api/v2/payouts/senders/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'x-api-key: <api-key>'

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "profile_type": "enterprise",
  "legal_name": "<string>",
  "country_code": "<string>",
  "status": "pending",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "registration_number": "<string>",
  "address": "<string>",
  "contact_email": "<string>",
  "contact_phone": "<string>",
  "status_reason": "<string>"
}

Authorizations

x-api-key · string · header · required

API key for authentication

Authorization · string · header · required

ES256 JWT signed by the private key registered to the API key above. Claims: sub (=API key), uri, nbf, iat, exp, and bodyHash (HMAC-SHA512 of uri + rawBody + nbf using a shared secret, base64).

Path Parameters

id · string<uuid> · required

ID of the Sender

Response

200

application/json

Sender found

id · string<uuid> · required

profile_type · enum<string> · required

Available options: enterprise, individual

legal_name · string · required

country_code · string · required

status · enum<string> · required

Starts pending. No client action moves it — resolves automatically once asynchronous partner KYC/KYB review completes.

Available options: pending, ready, rejected

created_at · string<date-time> · required

updated_at · string<date-time> · required

registration_number · string | null

address · string | null

contact_email · string | null

contact_phone · string | null

status_reason · string | null

Present only when status is rejected.