Skip to content
LionrapidLionRapid Docs

Get Namespace Translations

GET
/api/integrations/translations/{locale}/{namespace}
curl --request GET \
  --url https://example.com/api/integrations/translations/example/example

Get all translations for a specific namespace.

Returns nested translation structure with ICU parameter schema, matching the format expected by LionRapid library clients.

Args: locale: Target language locale (e.g., “en”, “fr”, “de”) namespace: Translation namespace (e.g., “app”, “common”, “admin”) api_key: Integration API key for authentication

Returns: Complete namespace translations with metadata and schema

HTTP Status: - 200: At least one ready translation found - 404: Namespace doesn’t exist - 423: Namespace exists but zero translations ready

Raises: authentication_error: Invalid API key (401) validation_error: Invalid parameters (400) namespace_locked: Namespace exists but no translations ready (423) not_found: Namespace doesn’t exist (404) internal_error: Server error (500)

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
locale
required
Locale
string
namespace
required
Namespace
string

Header Parameters

Section titled “Header Parameters”
x-api-key
Any of:
string

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
TranslationResponse

Standard response for all translation requests (namespace and individual).

object
meta
required
TranslationMetaResponse

Response metadata

object
version
required
Version

API version

string
locale
required
Locale

Target locale

string
namespace
required
Namespace

Translation namespace

string
key
Any of:
string
source_context
Any of:
string
generated_at
required
Generated At

ISO timestamp of response generation

string
schema
required
Schema

ICU parameter schema mapping keys to parameter lists

object
key
additional properties
Array<string>
translations
required
Translations

Nested translation structure

object
key
additional properties
any
Example
{
  "meta": {
    "generated_at": "2025-10-02T12:00:00Z",
    "locale": "en",
    "namespace": "app",
    "source_context": "eng",
    "version": "1.0.0"
  },
  "schema": {
    "item": [
      "count"
    ],
    "user.profile.name": [],
    "welcome": []
  },
  "translations": {
    "item": "{count, plural, =0 {no items} one {# item} other {# items}}",
    "user": {
      "profile": {
        "email": "Email Address",
        "name": "Name"
      }
    },
    "welcome": "Welcome to our app!"
  }
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}