Skip to main content
curl -X POST https://api.chargeapi.co/v1/accounts/acct_R0WW9U61sLoQP1WdE5Mw0W9Vqlbnk6tA \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "metadata": {
    "account_segment": "enterprise"
  }
}'

{
    "id": "acct_R0WW9U61sLoQP1WdE5Mw0W9Vqlbnk6tA",
    "object": "account",
    "billing_details": {
        "billing_address": {
            "city": "Paris",
            "country": "FR",
            "line1": "10 Rue de la Paix",
            "line2": "Batiment A",
            "postal_code": "75002",
            "state": "Ile-de-France"
        }
    },
    "business_type": null,
    "contact": {
        "email": "example@example.com",
        "name": "Example",
        "phone": "+33189000010"
    },
    "created": "2026-04-01T00:12:16.501Z",
    "default_currency": "eur",
    "description": null,
    "email": "example@example.com",
    "metadata": {
        "account_segment": "enterprise"
    },
    "metric_system": "metric",
    "name": "Example Account",
    "plan": "professional",
    "preferences": {
        "billing_cycle": "monthly",
        "default_currency": "eur",
        "default_payment_method": null,
        "notifications": true,
        "report_frequency": "weekly",
        "reporting_enabled": true
    },
    "registration_number": null,
    "status": "active",
    "type": "business",
    "updated": "2026-04-01T02:11:41.598Z",
    "wallet_balance": 42850
}

Documentation Index

Fetch the complete documentation index at: https://docs.chargeapi.co/llms.txt

Use this file to discover all available pages before exploring further.

Updates an account. Parameters you omit keep their current values. 
curl -X POST https://api.chargeapi.co/v1/accounts/acct_R0WW9U61sLoQP1WdE5Mw0W9Vqlbnk6tA \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "metadata": {
    "account_segment": "enterprise"
  }
}'

{
    "id": "acct_R0WW9U61sLoQP1WdE5Mw0W9Vqlbnk6tA",
    "object": "account",
    "billing_details": {
        "billing_address": {
            "city": "Paris",
            "country": "FR",
            "line1": "10 Rue de la Paix",
            "line2": "Batiment A",
            "postal_code": "75002",
            "state": "Ile-de-France"
        }
    },
    "business_type": null,
    "contact": {
        "email": "example@example.com",
        "name": "Example",
        "phone": "+33189000010"
    },
    "created": "2026-04-01T00:12:16.501Z",
    "default_currency": "eur",
    "description": null,
    "email": "example@example.com",
    "metadata": {
        "account_segment": "enterprise"
    },
    "metric_system": "metric",
    "name": "Example Account",
    "plan": "professional",
    "preferences": {
        "billing_cycle": "monthly",
        "default_currency": "eur",
        "default_payment_method": null,
        "notifications": true,
        "report_frequency": "weekly",
        "reporting_enabled": true
    },
    "registration_number": null,
    "status": "active",
    "type": "business",
    "updated": "2026-04-01T02:11:41.598Z",
    "wallet_balance": 42850
}

​
Parameters

​
description
string
Internal description or note.
​
email
string
Updated contact email.
​
name
string
New display name for the account.
​
plan
string
Change the subscription plan.

​
More parameters

​
metadata
object
Set of key-value pairs that you can attach to an object.
​
metric_system
string
Updated measurement system preference.Available options: metric, imperial
​
preferences
object
Settings for billing, notifications, and reporting.
​
status
string
Set operational status for the account.Available options: active, suspended, archived

​
Returns

Returns the updated account.