Get eligible languages

Enterprise

This endpoint is part of Countly Enterprise. To get access, contact sales or compare versions. Existing customers can reach the support portal with questions.

Endpoint

/o/content/langs

Overview

Returns language distribution for app users and optional content-block translation languages.

Authentication

Pass api_key or auth_token as a query parameter, or send countly-token as a header. See Authentication.

Permissions

• Required permission: Read on the content feature

Request Parameters

Parameter	Type	Required	Description
api_key	String	Yes (or auth_token)	API key for authentication
auth_token	String	Yes (or api_key)	Auth token for authentication
app_id	String	Yes	Application identifier
content_id	String	No	Content block ID; when set, translation languages found in this block are merged into the result

Examples

Example 1: Get Eligible Languages for App

/o/content/langs?api_key=YOUR_API_KEY&app_id=5be987d7b93798516eb5289a

Example 2: Get Eligible Languages for Specific Content Block

/o/content/langs?api_key=YOUR_API_KEY&app_id=5be987d7b93798516eb5289a&content_id=5d4472152de8f07336f3b352

Response

Success Response

{
  "default": "en",
  "eligibleLanguages": [
    {
      "code": "en",
      "name": "English",
      "percentage": 64
    },
    {
      "code": "es",
      "name": "Spanish",
      "percentage": 36
    },
    {
      "code": "de",
      "name": "German",
      "percentage": "~"
    }
  ]
}

Response Fields

Field	Type	Description
default	String	Default language (member language or en)
eligibleLanguages	Array	Languages list
eligibleLanguages[].code	String	Language code
eligibleLanguages[].name	String	Language name
eligibleLanguages[].percentage	Number/String	User distribution percentage, or "~" when language is added from content translations only

Error Responses

HTTP Status	Response
500	Error message from language processing (for example "appId is required")

Behavior

1. Calculates language distribution from app user language values.
2. If content_id is provided, extracts translation language codes from the content block structure and merges missing languages into result.
3. Returns default plus eligibleLanguages.

Related Endpoints

• Content Blocks - Read: Retrieve content blocks
• SDK Read - Content Delivery: Fetch queued content

Implementation details

Database Collections

Collection	Used for	Data touched by this endpoint
countly.app_users{app_id}	Endpoint data source	** - Language distribution source
countly.content_blocks	Endpoint data source	** - Read only when content_id is provided