Skip to main content
POST
/
v1
/
customers
/
{id}
/
wallet-application
Submit a wallet application
curl --request POST \
  --url https://api.ledger.so/v1/customers/{id}/wallet-application \
  --header 'Authorization: Bearer <token>'
{
  "ok": true,
  "data": {
    "id": "wal_def456",
    "customerId": "cus_abc123",
    "chain": "solana",
    "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "status": "active",
    "walletType": "custodial",
    "createdAt": "2025-01-15T11:00:00Z"
  }
}

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string

Unique key to ensure idempotent request processing. Reusing a key for a different route or method returns 409 Conflict.

Example:

"idk_a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Path Parameters

id
string
required

The customer ID (prefixed with cus_).

Example:

"cus_abc123"

Response

Wallet provisioned successfully

ok
boolean
required

Indicates the request was successful.

data
object