List wallets

GET

/v1/organization/billing/wallets

// Use a delegated user OAuth token with org:billing:read in its issuing region.
const bird = new BirdClient({ apiKey: process.env.BIRD_OAUTH_ACCESS_TOKEN!, region: "eu1" });
await bird.billingWallets.list();

import os
# Use a delegated user OAuth token with org:billing:read in its issuing region.
client = Bird(api_key=os.environ["BIRD_OAUTH_ACCESS_TOKEN"], region="eu1")
client.billing_wallets.list()

// Use a delegated user OAuth token with org:billing:read in its issuing region.
client, err := bird.NewClient(option.WithAPIKey(os.Getenv("BIRD_OAUTH_ACCESS_TOKEN")), option.WithRegion("eu1"))
if err != nil {
	log.Fatal(err)
}
ctx := context.Background()
result, err := client.BillingWallets.List(ctx)
if err != nil {
	log.Fatal(err)
}
fmt.Println(result)

// Use a delegated user OAuth token with org:billing:read in its issuing region.
$bird = new Bird(getenv('BIRD_OAUTH_ACCESS_TOKEN') ?: '', region: 'eu1');
$bird->billingWallets->list();

curl -X GET "https://us1.platform.bird.com/v1/organization/billing/wallets" \
  -H "Authorization: Bearer $TOKEN"

Risposta200

{
  "data": [
    {
      "id": "wal_01krdgeqcxet5s7t44vh8rt9mg",
      "currency_code": "USD",
      "balance": "118.00",
      "settled_balance": "150.00",
      "renewal_reserved": "25.00",
      "renewal_required": "30.00",
      "collection_status": "none",
      "collection_renewal": "30.004",
      "collection_required": "42.00",
      "collection_usage_buffer": "10.00",
      "collection_deficit": "2.00",
      "credit_limit": "0.00"
    }
  ]
}

Returns all wallets for the organization. A wallet is created automatically with the organization and pays usage charges. Amounts are decimal strings in currency_code; balance is the amount currently available to spend, excluding additional credit_limit headroom. Requires a delegated user OAuth token with org:billing:read; workspace and organization master API keys are refused with 403.

Payload di risposta

data

array of object

obbligatorio

Mostra attributi secondari

data.id

string

obbligatorio

data.currency_code

string

obbligatorio

ISO 4217 currency code.

data.balance

string

obbligatorio

Balance you can spend, in currency units. Usage is charged as it happens, so this drops within seconds of sending and can be lower than the balance the wallet transactions add up to, which only reflects charges that have settled. Funds held for upcoming renewals are also excluded. Credit headroom is reported separately in credit_limit, and postpaid accounts can keep spending past a zero balance up to that limit.

data.settled_balance

string

obbligatorio

Settled wallet balance in currency units, before active reservations are deducted.

data.renewal_reserved

string

obbligatorio

Amount currently held for prepared subscription renewals and scheduled plan changes, in currency units.

data.renewal_required

string

obbligatorio

Total amount required for prepared subscription renewals and scheduled plan changes, including tax, in currency units.

data.collection_status

string

obbligatorio

Automatic collection state:

none: No retained collection run.
in_progress: Collection is active, though payment may still require customer action.
exhausted: Automatic retries have stopped and customer action is needed.

Possible values: none, in_progress, exhausted

data.collection_renewal

string

obbligatorio

Part of collection_required needed for unfunded renewal fees, in exact currency units.

data.collection_required

string

obbligatorio

Total wallet funding still required by the current automatic collection run, in exact currency units.

data.collection_usage_buffer

string

obbligatorio

Part of collection_required needed for the configured auto-topup amount, in currency units.

data.collection_deficit

string

obbligatorio

Part of collection_required needed to cover the wallet shortfall after reservations and approved credit, in currency units.

data.credit_limit

string

obbligatorio

Credit limit in currency units. 0.00 for prepaid wallets.

data.provisional

boolean

obbligatorio

When true, the wallet currency has not yet been committed and can be changed once. When false, the currency is permanent.

data.created_at

string

obbligatorio

data.updated_at

string

obbligatorio

Continua con la documentazione, le guide e gli esempi per questo argomento.

Ottieni un brief di implementazione

// Use a delegated user OAuth token with org:billing:read in its issuing region.
const bird = new BirdClient({ apiKey: process.env.BIRD_OAUTH_ACCESS_TOKEN!, region: "eu1" });
await bird.billingWallets.list();

import os
# Use a delegated user OAuth token with org:billing:read in its issuing region.
client = Bird(api_key=os.environ["BIRD_OAUTH_ACCESS_TOKEN"], region="eu1")
client.billing_wallets.list()

// Use a delegated user OAuth token with org:billing:read in its issuing region.
client, err := bird.NewClient(option.WithAPIKey(os.Getenv("BIRD_OAUTH_ACCESS_TOKEN")), option.WithRegion("eu1"))
if err != nil {
	log.Fatal(err)
}
ctx := context.Background()
result, err := client.BillingWallets.List(ctx)
if err != nil {
	log.Fatal(err)
}
fmt.Println(result)

// Use a delegated user OAuth token with org:billing:read in its issuing region.
$bird = new Bird(getenv('BIRD_OAUTH_ACCESS_TOKEN') ?: '', region: 'eu1');
$bird->billingWallets->list();

curl -X GET "https://us1.platform.bird.com/v1/organization/billing/wallets" \
  -H "Authorization: Bearer $TOKEN"

Risposta200

{
  "data": [
    {
      "id": "wal_01krdgeqcxet5s7t44vh8rt9mg",
      "currency_code": "USD",
      "balance": "118.00",
      "settled_balance": "150.00",
      "renewal_reserved": "25.00",
      "renewal_required": "30.00",
      "collection_status": "none",
      "collection_renewal": "30.004",
      "collection_required": "42.00",
      "collection_usage_buffer": "10.00",
      "collection_deficit": "2.00",
      "credit_limit": "0.00"
    }
  ]
}

List wallets

Payload di risposta

Risorse correlate