BizKitHub
DocsAPI ReferenceLocalization/api/v1/localization/editions
getLocalizationPublic API v1

/api/v1/localization/editions

Editions a multi-region publication can serve, derived from the languages enabled for the organisation and the real-world country × language matrix (core__country_language, Unicode CLDR).

  • languages — one international edition per enabled language (URL /en, /cs). It lists posts without any country / continent rule (/post/feed?country=INT).
  • regional — one regional edition per country where an enabled language is official (URL /de-ch, /it-ch). It lists the unrestricted posts plus those restricted to the country or its continent (/post/feed?country=CH).

There is no default edition; isDefault only marks the organisation primary locale as a last-resort fallback. Safe to cache for minutes.

localizationgetApiV1LocalizationEditions

Parameters

1 query

Query parameters

· 1
apiKeystringRequired

Your BizKitHub API key (passed as GET parameter).

Key format: A 32-character string matching: ^(PROD|DEV_|ROOT)[A-Za-z0-9]{28}$
Prefixes: PROD (production key), DEV_ (individual developer), ROOT (system key with no limits). Learn more

ExamplePRODPGrFxpGEtrOZfuWhnoJohUYBXuOE

Response schema

1 status code documented

200Success
languagesobject[]Required
Each array item:
codestringRequired

ISO 639-1 language code.

Examplede
isDefaultbooleanRequired

Organisation primary locale (informational).

positionnumberRequired
regionalobject[]Required
Each array item:
keystringRequired

URL key {language}-{country}, lowercase.

Examplede-ch
languageCodestringRequired
Examplede
countryCodestringRequired

ISO 3166-1 alpha-2, uppercase.

ExampleCH
countryNamestringRequired
ExampleSwitzerland
continentCodestringRequired
ExampleEU
officialStatusstringRequired

CLDR status: official, de_facto_official or official_regional.

Exampleofficial
populationPercentnumberRequired

Share of speakers (CLDR estimate).

Example76
postCountnumberRequired

Public posts restricted to this country (directly or via its continent). Zero = the edition only mirrors the international one: canonicalize its listings there and do not advertise it.

Example3

Response example

application/json
{
  "languages": [
    {
      "code": "de",
      "isDefault": false,
      "position": 0
    }
  ],
  "regional": [
    {
      "key": "de-ch",
      "languageCode": "de",
      "countryCode": "CH",
      "countryName": "Switzerland",
      "continentCode": "EU",
      "officialStatus": "official",
      "populationPercent": 76,
      "postCount": 3
    }
  ]
}

Request example

GET /api/v1/localization/editions

get
curl -X GET "https://api.bizkithub.com/api/v1/localization/editions?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE" \
  -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