Salesforce B2C Commerce 24.7 > Open Commerce API 23.2 > Data API resources 23.2

LocaleInfo resource (Data API 23.2)

Summary

Http Method	Resource	Description
GET	/locale_info/locales	Action to get the set of active locales for which the user has read or write permission.

Get Locales

Action to get the set of active locales for which the user has read or write permission.

Url

GET https://hostname:port/dw/data/v23_2/locale_info/locales?id={String}&select={String}&start={Integer}&count={Integer}

Formats

json, xml

Authentication

Name	Description
OAuth	Authentication via OAuth token.

Response Document

LocaleResult

Query Parameters

Parameter	Type	Description
count	Integer	the count of the records to return in this page. Default is 25.
id	String	optional locale to return by id. If specified, that locale is looked up and returned, otherwise the list is returned.
select	String	the set of fields to return from the request. Default is only the locale id.
start	Integer	the start index for paging. Default is 0.

Sample

IREQUEST:
GET /s/-/dw/data/v23_2/locale_info/locales?select=(**) HTTP/1.1
Host: example.com
Authorization: Bearer a5b6eb0d-8312-41a3-88f3-2c53c4507367

RESPONSE:
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "23.2",
   "_type" : "locale_result",
   "count" : 4,
   "hits" :
   [
      {
         "_type" : "locale",
         "active" : true,
         "country" : "",
         "default" : true,
         "display_country" : "",
         "display_language" : "",
         "display_name" : "default",
         "id" : "default",
         "iso3_country" : "",
         "iso3_language" : "",
         "language" : "",
         "name" : "default"
      },
      {
         "_type" : "locale",
         "active" : true,
         "country" : "",
         "default" : false,
         "display_country" : "",
         "display_language" : "español",
         "display_name" : "español",
         "id" : "es",
         "iso3_country" : "",
         "iso3_language" : "spa",
         "language" : "es",
         "name" : "Spanish"
      }
   ],
   "select" : "(**)",
   "start" : 0,
   "total" : 4
}

REQUEST:
GET /s/-/dw/data/v23_2/locale_info/locales?id=en-US&select=(**) HTTP/1.1
Host: example.com
Authorization: Bearer a5b6eb0d-8312-41a3-88f3-2c53c4507367

RESPONSE:
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0,no-cache,no-store,must-revalidate
{
   "_v" : "23.2",
   "_type" : "locale_result",
   "count" : 1,
   "hits" : [
      {
         "_type" : "locale",
         "active" : true,
         "country" : "US",
         "default" : false,
         "display_country" : "United States",
         "display_language" : "English",
         "display_name" : "English (United States)",
         "id" : "en-US",
         "iso3_country" : "USA",
         "iso3_language" : "eng",
         "language" : "en",
         "name" : "English (United States)"
      }
   ],
   "id": "en-US",
   "select" : "(**)",
   "start" : 0,
   "total" : 1
}

X OCAPI versions 15.x and 16.x will be retired on March 31, 2021. For dates and more information, see the OCAPI versioning and deprecation policy and this Knowledge Article.