Update the customer bank destination

PUT https://api.leapa.co/v2/customers/{customer_id}/destination/bank/{account_id}

This endpoint needs your API key

Send it as a bearer token in the Authorization header. A request without one is answered with 401. See Authentication for where to find your key and how to keep it secret.

Request

curl -X PUT "https://api.leapa.co/v2/customers/cus_3d8e51fa20/destination/bank/acc_62f3a8d15b" \
  -H "Authorization: Bearer $LEAPA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": {
      "city": "string",
      "state": "string",
      "type": "personal",
      "country": "BI",
      "zip": "string",
      "line1": "string",
      "line2": "string"
    },
    "default": false
  }'

Response

{
  "holder_type": "individual",
  "bank_response": {
    "object": "string",
    "address": {
      "object": "string",
      "city": "string",
      "type": "personal",
      "status": "invalid",
      "state": "string",
      "zip": "string",
      "line1": "string",
      "line2": "string"
    },
    "defaultPayout": false,
    "owner_name": "Jeanne Ndayishimiye",
    "type": "bank",
    "bank_name": "Jeanne Ndayishimiye",
    "account_id": "acc_62f3a8d15b",
    "default": false,
    "account_number": "00012345678901",
    "routing_number": "string",
    "created_at_date": 0
  }
}

Path parameters

Values that go into the URL itself.

customer_idstringrequired
Example:cus_3d8e51fa20
account_idstringrequired
Example:acc_62f3a8d15b

Request body

application/json

Required. Send it as JSON.

addressAddressRequestRestricted
- citystringrequired
  City. Constraints: Not null, Size(min=3, max=90)
  Must be:3 to 90 characters
- statestring
  State. Constraints: Size(min=1, max=90)
  Must be:1 to 90 characters
- typestringrequired
  The type of address. Constraints: Not null
  Allowed values:personalbusiness
- countrystringrequired
  2 letter ISO Country Code. Constraints: Not null, Size(min=2, max=3)
  Allowed values:BICM
- zipstring
  Zip. Constraints: Size(min=1, max=15)
  Must be:1 to 15 characters
- line1stringrequired
  Line 1. Constraints:Not null, Size(min=1, max=90)
  Must be:1 to 90 characters
- line2stringrequired
  Line 2. Constraints: Size(min=1, max=90)
  Must be:1 to 90 characters
defaultboolean
Indicating whether this bank account is the default payout account. Constraints: Not null

Response

application/json

holder_typestringrequired
Holder Type
Allowed values:individualcompany
bank_responseBankResponserequired
- objectstring
  Object name
- addressAddressResponse
- defaultPayoutboolean
- owner_namestring
  Name of the account owner.
- typestring
  Type of payout account.
  Allowed values:bankmobilecash
- bank_namestring
  Bank Name
- account_idstring
  Account id.
- defaultboolean
  Flag indicating whether the account is a default payout or not.
- account_numberstring
  Account Number
- routing_numberstring
  Routing transit number for the bank account
- created_at_dateinteger<int64>
  The date and time that the payout was created

Status codes

200OK
400Bad request
401Unauthorized
402Payment required
403Forbidden
404Not found
428Precondition required
500Server error

Request

curl -X PUT "https://api.leapa.co/v2/customers/cus_3d8e51fa20/destination/bank/acc_62f3a8d15b" \
  -H "Authorization: Bearer $LEAPA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": {
      "city": "string",
      "state": "string",
      "type": "personal",
      "country": "BI",
      "zip": "string",
      "line1": "string",
      "line2": "string"
    },
    "default": false
  }'

Response

{
  "holder_type": "individual",
  "bank_response": {
    "object": "string",
    "address": {
      "object": "string",
      "city": "string",
      "type": "personal",
      "status": "invalid",
      "state": "string",
      "zip": "string",
      "line1": "string",
      "line2": "string"
    },
    "defaultPayout": false,
    "owner_name": "Jeanne Ndayishimiye",
    "type": "bank",
    "bank_name": "Jeanne Ndayishimiye",
    "account_id": "acc_62f3a8d15b",
    "default": false,
    "account_number": "00012345678901",
    "routing_number": "string",
    "created_at_date": 0
  }
}