---
title: "Get market versions"
method: GET
path: "/v1/projects/{projectId}/markets/details"
tags: ["markets"]
---

# Get market versions

`GET /v1/projects/{projectId}/markets/details`

The endpoint will return the markets in active status according to the query parameters: market code and registration type

## Path parameters

- `projectId` string, required

## Query parameters

- `marketCode` string
- `activePolicies` boolean
- `pageToken` string
- `pageSize` integer
- `registrationType` 'ALPHANUMERIC_SENDER_ID' | 'LONG_NUMBER' | 'SHORT_CODE' | 'RCS_AGENT', enum

## Response `200`

OK

- ListMarketVersionsResponse
  - `marketVersions` MarketVersion[] — List of Market versions that matches with the request criteria.
    - `createTime` string, date-time — Creation time of this major/minor market version.
    - `id` string — Market Version Id.
    - `majorVersion` integer — Major version of the policy. Indicates market requirement changes that may require resubmitting requests in progress.
    - `marketCode` string — ISO country code.
    - `minorVersion` integer — Minor version of the policy. Indicates market requirement changes that do not require resubmitting requests in progress.
    - `registrationType` 'ALPHANUMERIC_SENDER_ID' | 'LONG_NUMBER' | 'SHORT_CODE' | 'RCS_AGENT', enum — Type of Sender ID referenced by this market.
    - `specialConditions` SpecialCondition
      - `chainedSpecialConditions` ChainedSpecialCondition[] — A chained special conditions that contains an answer of a previous question, a new question/answers if needed, a policy id if there are no more questions
        - `answer` string — Answer to previous question
        - `description` string — The Description field provides context or additional information to help users understand the purpose and usage of the Answer field.
        - `chainedSpecialConditions` ChainedSpecialCondition[] — A chained special conditions that contains an answer of a previous question, a new question/answers if needed, a policy id if there are no more questions
        - `policyId` string — In markets without special conditions, the policy id is here. This field will be ignored (not exist) if there are chained special conditions
        - `prompt` string — A question to be answered with the chained special conditions. This field will be ignored (not exist) if there are not chained special conditions
      - `policyId` string — In markets without special conditions, the policy id is here. This field will be ignored (not exist) if there are chained special conditions
      - `prompt` string — A question to be answered with the chained special conditions. This field will be ignored (not exist) if there are not chained special conditions
    - `status` 'ACTIVE' | 'DISABLED', enum — Market status, it can be active or disabled
  - `nextPageToken` string — next token to be used to retrieve more markets
  - `totalSize` integer — Total Number of markets.

## Other responses

- `400` — Token not valid

---

[API](https://skmtc.net/sinch/apis/sinch-sender-id-registrations-api.md) · [All operations](https://skmtc.net/sinch/apis/sinch-sender-id-registrations-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinch/sinch-sender-id-registrations-api/revisions/e93587db2688/schema)