The account and its client companies
The account the key belongs to, then the client companies the key can act on (its member must manage them). The Getbeel-Company header does not apply to /companies.
The account the key belongs to, then the client companies the key can act on (its member must manage them). The Getbeel-Company header does not apply to /companies.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
OK
application/json- response
object*stringdata*array<>has_more*booleannext_cursor*string|nullcurl -X GET 'https://www.getbeel.com/api/v1/companies'{ "object": "list", "data": [ { "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" ] } } ], "has_more": true, "next_cursor": "string"}Sync a bank connection now POST
getbeel already syncs every 6 hours. Banks allow about four unattended fetches a day, and this call counts as one (429 bank_daily_limit when they are used up). New transactions are deduplicated, added to the month's synced statement and matched in the background (webhooks bank_statement.parsed, then reconciliation.completed). New movements cost €0.02 each, from the prepaid balance. Live keys only (403 livemode_required with a test key): bank and connection data is real, there is no sandbox for it.
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.