Skip to main content
GET
/
api
/
payouts
/
account-requirements
Get account requirements
curl --request GET \
  --url https://business.madhousewallet.com/api/payouts/account-requirements \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "type": "iban",
      "title": "IBAN",
      "fields": [
        {
          "name": "Legal type",
          "group": [
            {
              "key": "legalType",
              "name": "Legal type",
              "type": "select",
              "required": true,
              "refreshRequirementsOnChange": true,
              "valuesAllowed": [
                {
                  "key": "PRIVATE",
                  "name": "Person"
                },
                {
                  "key": "BUSINESS",
                  "name": "Business"
                }
              ]
            }
          ]
        },
        {
          "name": "IBAN",
          "group": [
            {
              "key": "iban",
              "name": "IBAN",
              "type": "text",
              "required": true,
              "refreshRequirementsOnChange": false,
              "example": "DE89370400440532013000",
              "minLength": 14,
              "maxLength": 42,
              "validationRegexp": "^[A-Z]{2}[0-9]{2}[A-Z0-9]{1,30}$"
            }
          ]
        }
      ]
    }
  ]
}

Authorizations

Authorization
string
header
required

Pass your API key as a Bearer token: Authorization: Bearer mw_live_<keyId>_<secret>

Query Parameters

currency
string
required

ISO 4217 target currency code. Supported currencies (81): AED, ALL, ARS, AUD, BAM, BDT, BHD, BMD, BOB, BRL, BWP, CAD, CHF, CLP, CNY, COP, CRC, CVE, CZK, DKK, DOP, EGP, EUR, GBP, GEL, GHS, GMD, GNF, GTQ, HKD, HNL, HUF, IDR, ILS, INR, ISK, JPY, KES, KGS, KHR, KRW, KWD, LAK, LKR, MAD, MNT, MOP, MUR, MXN, MYR, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PEN, PHP, PKR, PLN, PYG, QAR, RON, RSD, RWF, SAR, SCR, SEK, SGD, SRD, THB, TND, TRY, TZS, UAH, UGX, USD, UYU, VND, ZAR.

Example:

"EUR"

Response

Account requirements returned

data
object[]