Admins only. Your account starts as a company named after you. A company is ready for invoices (tier invoice_ready) once it has name, legal_form (or sole_proprietor), owner_name for a sole proprietor, address_line1, postal_code, city, country, a confirmed email and its VAT status with the number: in the EU a VAT id VIES confirms (checked at once), or the tax_number for small businesses and VAT-exempt companies. Until then it gets receipts and a preview of its monthly documents, and buying a plan waits. Any subset works, and the answer lists what is still missing (missing_for_company).
View input schema
{
"type": "object",
"properties": {
"name": {
"description": "Legal name of the company, without the legal form",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"legal_form": {
"description": "GmbH, UG, AG, e.K., Inc., ...",
"type": "string",
"maxLength": 40
},
"address_line1": {
"description": "Street and number of the registered address",
"type": "string",
"minLength": 2,
"maxLength": 120
},
"address_line2": {
"description": "Optional second line of the address",
"type": "string",
"maxLength": 120
},
"postal_code": {
"description": "Postal code of the registered address",
"type": "string",
"minLength": 3,
"maxLength": 12
},
"city": {
"description": "City of the registered address",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"address_state": {
"description": "State or province, written after the city in the USA, Canada and Australia (TX, ON, NSW)",
"type": "string",
"maxLength": 40
},
"owner_name": {
"description": "A sole proprietorship (Einzelunternehmen, e.K., sole trader ...): the first and last name of the owner. It stands on every document, never in the register or on a listing. Empty removes it",
"type": "string",
"maxLength": 120
},
"sole_proprietor": {
"description": "True for one person without a legal form of its own where the country has none to choose. Then owner_name is required",
"type": "boolean"
},
"country": {
"description": "ISO 3166 two-letter code, e.g. DE",
"type": "string"
},
"language": {
"description": "Language of documents and mails: en, de, fr, it, es, nl, pt, sv, da, fi or nb. Null takes the language of the country",
"type": [
"string",
"null"
]
},
"vat_id": {
"description": "VAT id in the format of its country, like DE123456789 or ATU12345678 (GET /v1/countries). EU numbers are checked against VIES",
"type": "string",
"maxLength": 30
},
"tax_number": {
"description": "The national tax number, for vat_status tax_number or where the country asks for it",
"type": "string",
"maxLength": 30
},
"vat_status": {
"description": "How the company stands with VAT: vat_id, tax_number (registered, VAT id still to come), small_business (§ 19 UStG) exempt (only VAT-exempt sales) or not_registered (no VAT registration, the USA or another country without VAT). Decides the tax note on its documents",
"anyOf": [
{
"type": "string",
"enum": [
"vat_id",
"tax_number",
"small_business",
"exempt",
"not_registered"
]
},
{
"type": "null"
}
]
},
"skr": {
"description": "Chart of accounts for exports. OWN takes own_accounts",
"type": "string",
"enum": [
"SKR03",
"SKR04",
"OWN"
]
},
"own_accounts": {
"description": "With skr OWN: the expense, clearing and USDC holding accounts of your chart, 4 to 8 digits, and optionally gift_cards for gift card purchases (the expense account otherwise)",
"anyOf": [
{
"type": "object",
"properties": {
"expense": {
"type": "string",
"pattern": "^\\d{4,8}$"
},
"clearing": {
"type": "string",
"pattern": "^\\d{4,8}$"
},
"usdc": {
"type": "string",
"pattern": "^\\d{4,8}$"
},
"gift_cards": {
"type": "string",
"pattern": "^\\d{4,8}$"
}
},
"required": [
"expense",
"clearing",
"usdc"
]
},
{
"type": "null"
}
]
},
"currency": {
"description": "The currency amounts are shown in, next to USDC: EUR (default, the currency of the documents), USD, or any currency with an ECB reference rate",
"type": "string",
"pattern": "^[A-Za-z]{3}$"
},
"fx_method": {
"description": "How USDC becomes EUR on documents. Today only ecb_daily (ECB reference rate of the payment day)",
"type": "string",
"enum": [
"ecb_daily"
]
},
"email": {
"description": "Where documents and notices go. A code confirms it",
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"proof": {
"description": "An EIP-4361 message you got from a challenge, signed by your wallet",
"type": "object",
"properties": {
"message": {
"type": "string"
},
"signature": {
"type": "string"
}
},
"required": [
"message",
"signature"
]
},
"session_token": {
"description": "A lounge session token (lg_...) if you have one",
"type": "string"
},
"client": {
"description": "Your client name, e.g. \"claude-code 2.1\"",
"type": "string",
"maxLength": 40
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}