BizKitHub
DocsAPI ReferenceOrganisation/bff/organisation/legal-forms
getOrganisationAdmin BFF

/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. The optional locale query param translates the name field for CZ/SK/AT/DE forms.

OrganisationgetBffOrganisationLegal-forms

Parameters

2 query

Query parameters

· 2
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
localestringOptional

Optional label locale. When provided and a translation exists for (countryCode, slug), the response name is the localised label; otherwise the DB name is returned unchanged.

Exampleen

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&locale=en" \
  -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