Skip to main content
POST
/
v1
/
customers
/
{id}
/
rain-application
Submit a card application
curl --request POST \
  --url https://api.ledger.so/v1/customers/{id}/rain-application \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "birthDate": "1990-05-15",
  "nationalId": "123-45-6789",
  "countryOfIssue": "US",
  "address": {
    "line1": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "postalCode": "94105",
    "country": "US"
  },
  "ipAddress": "203.0.113.42",
  "occupation": "Software Engineer",
  "annualSalary": 120000,
  "accountPurpose": "business_expenses",
  "expectedMonthlyVolume": 5000,
  "phoneCountryCode": "+1",
  "phoneNumber": "4155551234",
  "solanaAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
}
'
{
  "ok": true,
  "data": {
    "applicationId": "<string>",
    "status": "submitted"
  }
}

Authorizations

​
Authorization
string
header
required

API key passed as a Bearer token. Format: ld_<env>_<prefix>_<secret> where <env> is test or live.

Path Parameters

​
id
string
required

The customer ID (prefixed with cus_).

Example:

"cus_abc123"

Body

application/json
​
birthDate
string<date>
required

Customer's date of birth in YYYY-MM-DD format.

Example:

"1990-05-15"

​
nationalId
string
required

Government-issued national identification number (e.g., SSN for US customers).

Example:

"123-45-6789"

​
countryOfIssue
string
required

ISO 3166-1 alpha-2 country code for the national ID.

Example:

"US"

​
address
object
required

Customer's residential address.

​
ipAddress
string<ipv4>
required

Customer's IP address at the time of application.

Example:

"203.0.113.42"

​
occupation
string
required

Customer's occupation or job title.

Example:

"Software Engineer"

​
annualSalary
number
required

Customer's annual salary in USD.

Example:

120000

​
accountPurpose
string
required

Intended purpose for the card account.

Example:

"business_expenses"

​
expectedMonthlyVolume
number
required

Expected monthly transaction volume in USD.

Example:

5000

​
phoneCountryCode
string
required

Phone country code with leading +.

Example:

"+1"

​
phoneNumber
string
required

Phone number without country code.

Example:

"4155551234"

​
solanaAddress
string
required

Customer's Solana wallet address for card funding.

Example:

"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"

Response

Application submitted successfully

​
ok
boolean
required

Indicates the request was successful.

​
data
object