Get Supported Markets

Retrieves the list of supported markets available in the C3 platform. The response includes country, region, market code, and currency information that can be used when creating reseller plans, customer plans, pricing configurations, and market-specific product catalogs.

Endpoint

{{apiUrl}}/api/common/supportedMarketList

Endpoint Parameters

Parameter	Required	Description
`{{apiUrl}}`	Yes	C3 Portal API URL.

Request Headers

Header	Value
Authorization	Bearer <access_token>
Content-Type	application/json

Request Body

No request body is required for this endpoint.

Successful Response

A successful request returns all supported markets configured in the C3 platform. These values can be used when creating plans and configuring market-specific catalogs and pricing.

Sample Response

{
  "OperationType": null,
  "Status": "Success",
  "RequestCorrelationID": "37c646e4-144b-410c-b504-f623ec9a07b5",
  "ErrorMessage": null,
  "ErrorDetail": null,
  "Data": [
    {
      "ID": 234,
      "Region": "North America",
      "MarketCountry": "United States",
      "MarketCode": "US",
      "Currency": "USD"
    }
  ]
}

Response Properties

Property	Description
OperationType	Reserved for internal use. Can be ignored.
Status	Indicates the result of the request. Possible values: Success or Error.
RequestCorrelationID	Unique identifier generated by C3 for request tracking and troubleshooting.
ErrorMessage	Error message returned if request processing fails.
ErrorDetail	Additional error information.
Data	Collection of supported market records.

Supported Market Attributes

Attribute	Description
ID	Unique record identifier in the API response.
Region	Geographical region associated with the market.
MarketCountry	Name of the supported country or market.
MarketCode	Two-letter market code used throughout C3 for plan, offer, and pricing configurations.
Currency	Default currency associated with the market.

Usage Information

The MarketCode and Currency values returned by this API are commonly used while creating reseller plans and customer plans. These values determine which offers, pricing, and catalogs are available within a specific market.

Error Response

If the request cannot be authenticated or processed, the API returns an error response containing details about the failure.

Error Response Properties

Property	Description
OperationType	Reserved for internal use. Can be ignored.
Status	Indicates the result of the request. Possible values: Success or Error.
RequestCorrelationID	Unique identifier generated by C3 for troubleshooting purposes.
ErrorMessage	Summary of the error encountered.
ErrorDetail	Additional error details.

Example Use Cases

Retrieve supported markets before creating reseller plans.
Determine the default currency associated with a specific market.
Configure market-specific offer availability and plan assignments.