POST
/
wallets
LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"

curl --location --request POST "$LAGO_URL/api/v1/wallets" \
  --header "Authorization: Bearer $API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "wallet": {
      "name": "Prepaid",
      "rate_amount": "1.5",
      "paid_credits": "20.0",
      "granted_credits": "10.0",
      "currency": "USD",
      "expiration_at": "2022-07-07",
      "external_customer_id": "hooli_1234"
    }
  }'

{
  "wallet": {
    "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
    "lago_customer_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
    "external_customer_id": "hooli_1234",
    "status": "active",
    "currency": "USD",
    "name": "Prepaid",
    "rate_amount": "1.5",
    "credits_balance": "28.0",
    "balance_cents": 1000,
    "consumed_credits": "2.0",
    "created_at": "2022-04-29T08:59:51Z",
    "expiration_at": null,
    "last_balance_sync_at": "2022-04-29T08:59:51Z",
    "last_consumed_credit_at": "2022-04-29T08:59:51Z",
    "terminated_at": "2022-09-14T16:35:31Z",
    "invoice_requires_successful_payment": false,
    "recurring_transaction_rules": [
      {
        "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
        "trigger": "interval",
        "method": "target",
        "interval": "monthly",
        "status": "active",
        "threshold_credits": "20.0",
        "paid_credits": "20.0",
        "granted_credits": "10.0",
        "started_at": "2022-08-08T00:00:00Z",
        "target_ongoing_balance": "200.0",
        "created_at": "2022-04-29T08:59:51Z",
        "expiration_at": "2023-09-30T23:59:59Z",
        "invoice_requires_successful_payment": false,
        "transaction_metadata": [
          {
            "key": "example_key",
            "value": "example_value"
          },
          {
            "key": "another_key",
            "value": "another_value"
          }
        ]
      }
    ],
    "ongoing_balance_cents": 800,
    "ongoing_usage_balance_cents": 200,
    "credits_ongoing_balance": "8.0",
    "credits_ongoing_usage_balance": "2.0"
  }
}
LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"

curl --location --request POST "$LAGO_URL/api/v1/wallets" \
  --header "Authorization: Bearer $API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "wallet": {
      "name": "Prepaid",
      "rate_amount": "1.5",
      "paid_credits": "20.0",
      "granted_credits": "10.0",
      "currency": "USD",
      "expiration_at": "2022-07-07",
      "external_customer_id": "hooli_1234"
    }
  }'

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
Wallet payload

The body is of type object.

Response

200
application/json
Wallet created

The response is of type object.