Jump to

• Request
• Response

Get Locales

post

/config/sim/v1/setup/getLocales

Request

Supported Media Types

• application/json
• multipart/form-data

Body ()

A request body to get the list of locales

Root Schema : LocaleGetRequestBody

Type: object

The input Body model that needs to be given.

Show Source

• include: string
  Objects included in response
• includeAll: string
  This can take 2 values: basic or detailed. If 'basic' is specified, The response contains all the properties of the object except Ext values. If 'detailed' is specified, The response contains all the properties of the object.

  Example: detailed
• languages: string
  If specified, limits translated strings returned
• limit: integer
  If using paging, number of results returned in this page.
• offset: integer
  Starting resource record index. Not required if paging parameters are not supported
• orderBy: string
  Sorts the response by the specified field name and sort order.
• searchCriteria: string
  Search criteria to filter results based on field value

{
    "type":"object",
    "properties":{
        "searchCriteria":{
            "type":"string",
            "description":"Search criteria to filter results based on field value"
        },
        "include":{
            "type":"string",
            "description":"Objects included in response"
        },
        "includeAll":{
            "type":"string",
            "example":"detailed",
            "description":"This can take 2 values: basic or detailed.\nIf 'basic' is specified, The response contains all the properties of the object except <options-string-name>Ext values.\nIf 'detailed' is specified, The response contains all the properties of the object.\n"
        },
        "languages":{
            "type":"string",
            "description":"If specified, limits translated strings returned"
        },
        "offset":{
            "type":"integer",
            "description":"Starting resource record index. Not required if paging parameters are not supported"
        },
        "limit":{
            "type":"integer",
            "description":"If using paging, number of results returned in this page."
        },
        "orderBy":{
            "type":"string",
            "description":"Sorts the response by the specified field name and sort order."
        }
    },
    "description":"The input Body model that needs to be given."
}

Back to Top

Response

Supported Media Types

• application/json

200 Response

A collection of Locales in an organization.

Body ()

Root Schema : LocaleGetResponse

Type: object

Show Source

• count(required): integer
  Current response recount count.

  Example: 9
• hasMore(required): boolean
  Flag indicating if there are more objects to fetch.

  Example: true
• items(required): array items
  Array of data extension objects of the organization.
• limit(required): integer
  Server page size

  Example: 10
• offset(required): integer
  Starting resource record index

  Example: 0
• totalResults(required): integer
  Total number of rows (excluding the paging parameters)

  Example: 100

{
    "type":"object",
    "required":[
        "totalResults",
        "hasMore",
        "count",
        "items",
        "offset",
        "limit"
    ],
    "properties":{
        "totalResults":{
            "type":"integer",
            "example":100,
            "description":"Total number of rows (excluding the paging parameters)"
        },
        "hasMore":{
            "type":"boolean",
            "example":true,
            "description":"Flag indicating if there are more objects to fetch."
        },
        "count":{
            "type":"integer",
            "example":9,
            "description":"Current response recount count."
        },
        "items":{
            "type":"array",
            "description":"Array of data extension objects of the organization.",
            "items":{
                "$ref":"#/definitions/LocaleItemResponseBody"
            }
        },
        "offset":{
            "type":"integer",
            "example":0,
            "description":"Starting resource record index"
        },
        "limit":{
            "type":"integer",
            "example":10,
            "description":"Server page size"
        }
    }
}

Nested Schema : items

Type: array

Array of data extension objects of the organization.

Show Source

• Array of: object LocaleItemResponseBody
  Model for Locale Object

{
    "type":"array",
    "description":"Array of data extension objects of the organization.",
    "items":{
        "$ref":"#/definitions/LocaleItemResponseBody"
    }
}

Nested Schema : LocaleItemResponseBody

Type: object

Model for Locale Object

Show Source

• decimalSeparator: string
  Decimal Separator for the Locale

  Example: ,
• name: object name
  Additional Properties Allowed: additionalProperties

  name of the Locale
• objectNum: integer
  Object Number of the Locale

  Example: 1
• thousandsSeparator: string
  Thousands Separator for the Locale

  Example: .

{
    "type":"object",
    "properties":{
        "objectNum":{
            "type":"integer",
            "example":1,
            "description":"Object Number of the Locale"
        },
        "name":{
            "type":"object",
            "example":{
                "en-US":"Enterprise",
                "de-DE":"Unternehmen",
                "es-MX":"Empresa"
            },
            "description":"name of the Locale",
            "additionalProperties":{
                "type":"string"
            }
        },
        "decimalSeparator":{
            "type":"string",
            "example":",",
            "description":"Decimal Separator for the Locale"
        },
        "thousandsSeparator":{
            "type":"string",
            "example":".",
            "description":"Thousands Separator for the Locale"
        }
    },
    "description":"Model for Locale Object"
}

Nested Schema : name

Type: object

Additional Properties Allowed

Show Source

• string

{
    "type":"object",
    "example":{
        "en-US":"Enterprise",
        "de-DE":"Unternehmen",
        "es-MX":"Empresa"
    },
    "description":"name of the Locale",
    "additionalProperties":{
        "type":"string"
    }
}

name of the Locale

Example:

{
    "en-US":"Enterprise",
    "de-DE":"Unternehmen",
    "es-MX":"Empresa"
}

400 Response

400 Bad Request

Body ()

Root Schema : ErrorDetails

Type: object

Response body when the request returns an error.

Show Source

• detail(required): string
  A short, human-readable summary of the problem.

  Example: Specified Data is invalid
• errorDetails(required): string
  A human-readable explanation specific to this occurrence of the problem.

  Example: Entity Does Not Exist
• o:errorCode(required): integer
  Error code of the problem

  Example: 55223
• status(required): integer
  HTTP status code.

  Example: 400
• title(required): string
  A short, human-readable summary of the problem type.

  Example: VALIDATION ERROR
• type(required): string
  A URI reference that identifies the problem type. When this member is not present, its value is assumed to be "about:blank".

  Example: http://www.abc.org/xyz.html

{
    "description":"Response body when the request returns an error.\n",
    "type":"object",
    "required":[
        "o:errorCode",
        "detail",
        "status",
        "type",
        "title",
        "errorDetails"
    ],
    "properties":{
        "o:errorCode":{
            "description":"Error code of the problem",
            "type":"integer",
            "example":55223
        },
        "detail":{
            "description":"A short, human-readable summary of the problem.",
            "type":"string",
            "example":"Specified Data is invalid"
        },
        "status":{
            "description":"HTTP status code.",
            "type":"integer",
            "example":400
        },
        "type":{
            "description":"A URI reference that identifies the problem type. When this member is not present, its value is assumed to be \"about:blank\".",
            "type":"string",
            "example":"http://www.abc.org/xyz.html"
        },
        "title":{
            "description":"A short, human-readable summary of the problem type.",
            "type":"string",
            "example":"VALIDATION ERROR"
        },
        "errorDetails":{
            "description":"A human-readable explanation specific to this occurrence of the problem.",
            "type":"string",
            "example":"Entity Does Not Exist"
        }
    }
}

404 Response

404 Requested resource not found

Back to Top