---
search:
  tags:
    - billing
    - PUT
seo:
  description: >-
    Replaces the org's billing details. Owners' and admins' keys only (403
    forbidden otherwise). A… Reference for the PUT /v1/billing endpoint in the
    pols.so API.
sidebar:
  label: Set who the org's invoices are made out to
  badge: PUT
title: Set who the org's invoices are made out to
type: openapi-operation
---
Replaces the org's billing details. Owners' and admins' keys only
(403 `forbidden` otherwise). A field that cannot be saved is 400
`bad_request` with a message saying which and why.

A business may give a VIES-supported VAT ID with its explicit canonical
prefix (`EL` for Greece, `XI` for Northern Ireland) and in that prefix's
format, regardless of the billing address's country. A new such VAT ID, or one VIES
found invalid before, is checked against VIES before this answers,
so `vat.status` is usually `valid` or `invalid` already. If VIES
does not answer, the details are saved with the VAT ID
`unverified` and it is checked again later, after 5 minutes and
then at doubling intervals of up to 6 hours. An `invalid` VAT ID
is saved too. A business outside the EU may also give a non-EU
tax ID, which is stored as `not_checked`. Consumers give no VAT ID.

`PUT /v1/billing`