Company

Delete a company

Removes a company from the account: it stops appearing and stops being billed.

  • Existing invoices: those already issued are retained, but the company-scoped API can no longer resolve them once the NIF is removed.
  • What blocks removal: a NIF activated in Live (409 COMPANY_ACTIVE_IN_PRODUCTION), one holding any invoice in Live — issued, draft or proforma (409 COMPANY_HAS_INVOICES) — and the account's primary NIF (400 CANNOT_DELETE_PRIMARY).
  • Deactivating first: switching off in Live is scheduled to the end of the paid cycle, so the removal only becomes possible once that takes effect.
  • Test: NIFs never activated, or activated only in Test, are removed right away, and invoices in Test never block.
  • Idempotency-Key: without one, a retry after a timeout answers 403 instead of the original 204.
delete/v1/companies/{company_id}

Request

  • Base URL: https://app.beel.es/api
  • URL: https://app.beel.es/api/v1/companies/{company_id}
  • Auth: HTTP bearer

Response

Company deleted

Changes

No recorded changes to this operation across all 1 revision of this API.