---
title: "Set the org's billing address (owner/admin)"
method: PUT
path: "/v1/orgs/{org_id}/billing/address"
tags: ["billing"]
---

# Set the org's billing address (owner/admin)

`PUT /v1/orgs/{org_id}/billing/address`

## Request

- Base URL: `https://api.wavehouse.cloud`
- URL: `https://api.wavehouse.cloud/v1/orgs/{org_id}/billing/address`
- Auth: one of:
  - API key in cookie `whc_session`
  - HTTP bearer

Written to the payment provider, which computes tax from it. 409 for an org with no billing account yet: start a plan first.

## Path parameters

- `org_id` string, required

## Request body

- BillingAddressView
  - `city` string
  - `country` string, required: ISO-2 country code
  - `line1` string
  - `line2` string
  - `postal_code` string
  - `state` string

## Response `200`

OK

- BillingAccountView
  - `address` BillingAddressView
    - `city` string
    - `country` string, required: ISO-2 country code
    - `line1` string
    - `line2` string
    - `postal_code` string
    - `state` string
  - `payment_method` PaymentMethodView
    - `brand` string, required
    - `exp_month` integer, required
    - `exp_year` integer, required
    - `last4` string, required
  - `source` 'provider' | 'none' | 'unavailable', required: provider: read from the payment provider just now; none: the org has no billing account yet, and starting a plan makes one; unavailable: the provider could not be read, so address and card are unknown rather than empty

## Other responses

- `429`: Rate limited, per client IP, API key or org; a client IP is also refused on every route for a while after repeated authentication failures. A limited operation carries RateLimit-Policy and RateLimit on every response; wait Retry-After seconds before retrying.
- `default`: Error

---

[API](https://skmtc.dev/wavehouse/apis/wavehouse-cloud-api.md) · [All operations](https://skmtc.dev/wavehouse/apis/wavehouse-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wavehouse/apis/wavehouse-cloud-api/revisions/adea029bf505?raw)