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

# Get market versions

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

## Request

- Base URL: `https://senderid.registrations.api.sinch.com`
- URL: `https://senderid.registrations.api.sinch.com/v1/projects/{projectId}/markets/details`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.sinch.com/oauth2/token` scopes: `read`

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.dev/sinch/apis/sinch-sender-id-registrations-api.md) - [All operations](https://skmtc.dev/sinch/apis/sinch-sender-id-registrations-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sinch/apis/sinch-sender-id-registrations-api/revisions/fe69a3ac7d43?raw)