Get the account or one of its client companies
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
id*stringA client company id, or the key's own account id
uuidOK
application/json- response
object*stringid*stringSend it as the Getbeel-Company header (or the MCP company_id argument) to act on this company
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidname*stringslug*string|nullparent_id*|The parent (platform) account, null for the parent itself and for standalone accounts
company*|nullsdi_readiness*curl -X GET 'https://www.getbeel.com/api/v1/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08'{ "object": "company", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "slug": "string", "parent_id": "1c6ca187-e61f-4301-8dcb-0e9749e89eef", "company": { "name": "string", "vat_number": "string", "codice_fiscale": "string", "regime_fiscale": "RF01", "country": "string", "address": "string", "street_number": "string", "postal_code": "string", "city": "string", "province": "string", "preferred_currency": "string", "sdi_configured": true }, "sdi_readiness": { "ready": true, "missing": [ "name" ] }}Add a client company POST
Creates a client company under the key's account with its company data. The key's member becomes its owner, so the same key can act on it at once with the Getbeel-Company header. A client company cannot have client companies (409 company_nesting_not_allowed). Each company has its own plan: live SDI sends from a client company need its own SDI add-on. Live keys only (403 livemode_required with a test key): companies are real accounts, there is no sandbox for them.
Change company data PATCH
Changes only the fields sent. sdi_readiness shows what is still missing to issue invoices through SDI. Live keys only (403 livemode_required with a test key): company data is real, there is no sandbox for it.