CRISP partnersEndpoint reference

Get localization locales

GET /v1/localization/locales

Discover supported display locales, the default locale, batch limit and original-only rules policy. Uses your market-data access; no additional configuration for your organization or translation service is required.

Multilingual market displays guide · All endpoints · SDK: getLocalizationLocales

Authentication

Server-to-server HMAC. Your key selects the partner; your backend must authorize the end user.

CRISP enables access to the features agreed for your integration. Contact CRISP if an enabled feature returns an access error.

Idempotency-Key: Not required by this operation. Signing and authentication →

Request fields

Required means the field must be present. Nullable means an explicit JSON null is allowed; it does not mean optional.

Path parameters

None.

Query parameters

None.

Header parameters

No operation-specific headers. The HMAC headers above still apply.

JSON body

No request body.

Request example

Illustrative identifiers only: replace them with resources from your integration. Keep credentials on your backend. HTTP placeholders must be signed; the SDK signs automatically. Financial intent keys must be persisted and unique per new action.

GET /v1/localization/locales
Host: partner-api.crisp.trade
X-Crisp-Partner-Key: <server-key-id>
X-Crisp-Timestamp: <fresh-ISO-8601-UTC-timestamp>
X-Crisp-Nonce: <fresh-unique-nonce>
X-Crisp-Signature: <computed-base64-HMAC>

Response fields

HTTP responses use the envelope below. SDK calls expose its payload as result.data, with HTTP status and request metadata on the SDK wrapper.

200 · Success

Data payload

FieldType / presenceDescription and constraints
localesarray<string>
Required
Non-null
Expand the structure below.
locales: expand item fields

string

Allowed: "en", "zh", "zh-hant", "ja"

defaultLocalestring
Required
Non-null
Allowed: "en"
maxBatchSizeinteger
Required
Non-null
minimum: 0
rulesPolicystring
Required
Non-null
Allowed: "original_only"

Additional fields are not allowed in this object.

Full HTTP envelope
FieldType / presenceDescription and constraints
dataobject
Required
Non-null
Expand the structure below.
data: expand fields
FieldType / presenceDescription and constraints
localesarray<string>
Required
Non-null
Expand the structure below.
locales: expand item fields

string

Allowed: "en", "zh", "zh-hant", "ja"

defaultLocalestring
Required
Non-null
Allowed: "en"
maxBatchSizeinteger
Required
Non-null
minimum: 0
rulesPolicystring
Required
Non-null
Allowed: "original_only"

Additional fields are not allowed in this object.

requestIdstring
Required
Non-null

Request correlation ID for debugging and support.

Additional fields are not allowed in this object.

Response example

Schema illustration, not live account data. Null means unavailable or not applicable, never an invented zero. Empty arrays do not imply the endpoint always returns no results.

200 response JSON
{
  "data": {
    "locales": [],
    "defaultLocale": "en",
    "maxBatchSize": 0,
    "rulesPolicy": "original_only"
  },
  "requestId": "example-request-id"
}

Errors and recovery

StatusMeaning
400Inspect error.code and retain the original financial intent.
401Inspect error.code and retain the original financial intent.
403Inspect error.code and retain the original financial intent.
404Not visible for this account. A recovery lookup miss is not proof that an in-flight submission failed.
409Inspect error.code and retain the original financial intent.
429Inspect error.code and retain the original financial intent.
500Inspect error.code and retain the original financial intent.
502Inspect error.code and retain the original financial intent.
503Inspect error.code and retain the original financial intent.

Inspect the error code and outcomeUnknown, not just the HTTP status. Preserve the original intent after financial uncertainty. Read-only retries should honor Retry-After. Recovery workflow →

Error response fields
FieldType / presenceDescription and constraints
errorobject
Required
Non-null
Expand the structure below.
error: expand fields
FieldType / presenceDescription and constraints
codestring
Required
Non-null
—
messagestring
Required
Non-null
—
requestIdstring
Required
Non-null

Request correlation ID for debugging and support.

Additional fields are not allowed in this object.

Additional fields are not allowed in this object.

Raw contract

OpenAPI download · Advanced schema and legacy anchor

CRISP Partner Documentation