Get beneficiary | CrissCross

{
  "beneficiaryId": "ben_f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "status": "pending",
  "currency": "NGN",
  "name": "Acme Trading Ltd",
  "entityType": "business",
  "accountDetails": [
    {
      "type": "account_number",
      "value": "0123456789"
    }
  ],
  "routingDetails": [
    {
      "rail": "fiat",
      "paymentType": "ach",
      "routingNumber": "021000021",
      "routingNumberType": "aba",
      "bank": {
        "name": "JPMorgan Chase Bank",
        "address": "270 Park Avenue, New York, NY 10017"
      }
    }
  ],
  "createdAt": "2024-01-15T09:30:00Z",
  "statusReason": "compliance_review",
  "address": {
    "line1": "12 Commerce Street",
    "line2": "Suite 400",
    "city": "Lagos",
    "postcode": "100001",
    "country": "NG"
  },
  "activatedAt": null
}

Retrieves a single beneficiary by ID.

Authentication

AuthorizationBearer

Token obtained via the login flow.

Path parameters

beneficiaryIdstringRequired

Response

Beneficiary details.

beneficiaryIdstring

statusenum

Poll until active before referencing in a withdrawal.

currencystring

One currency per beneficiary.

namestring

Legal name.

entityTypeenum

accountDetailslist of objects

routingDetailslist of objects

createdAtdatetime

statusReasonenum or null

addressobject

activatedAtdatetime or null

Errors

401

Unauthorized Error

404

Not Found Error

$	curl https://api.crisscross.money/v1/beneficiaries/ben_f47ac10b-58cc-4372-a567-0e02b2c3d479 \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"