Docs API Reference Organisation/bff/organisation/legal-forms

/bff/organisation/legal-forms

Returns active legal forms from core__legal_form. Use to populate the legal form picker on the organisation profile and on contact detail. Pair with the contact/organisation accounting country.

OrganisationgetBffOrganisationLegal-forms

Parameters

1 query

Query parameters

· 1

countryIdstringOptional

Filter legal forms by country ID (from GET /organisation/available-countries). Strongly recommended — without it the response includes legal forms for all countries. Query params are always strings in Elysia; the value is parsed as a number server-side.

Example158

Response schema

1 status code documented

200Success

itemsobject[]Required

Active legal forms ordered by country, then position.

Each array item:

idnumberRequired

Legal form ID. Use as legalFormId in update-profile / contact detail-edit.

countryIdnumberRequired

Country this legal form belongs to.

countryCodestringRequired

ISO 3166-1 alpha-2 code of the country.

ExampleCZ

codestringRequired

Country-specific code (e.g. ARES "pravniForma").

Example112

slugstringRequired

Cross-country slug (osvc/sro/as/vos/ks/druzstvo/po/fo_podnikatel/neziskovka…).

Examplesro

namestringRequired

Localized human-readable name.

isLegalEntitybooleanRequired

true = legal entity (PO), false = natural person (FO). Drives accounting/invoice logic.

vatRegistrationDefaultbooleanRequired

Whether this legal form is typically a VAT payer by default (UI hint only — not auto-applied).

Response example

application/json

{
  "items": [
    {
      "id": 0,
      "countryId": 0,
      "countryCode": "CZ",
      "code": "112",
      "slug": "sro",
      "name": "example_name",
      "isLegalEntity": false,
      "vatRegistrationDefault": false
    }
  ]
}

Request example

GET /bff/organisation/legal-forms

get

curl -X GET "https://api.bizkithub.com/bff/organisation/legal-forms?countryId=158" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key