> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cevoid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get market by ID

> Retrieve a specific market by its ID or shortId



## OpenAPI

````yaml https://api.cevoid.com/v1/openapi.json get /v1/markets/{id}
openapi: 3.0.0
info:
  version: 1.0.0
  title: Cevoid Public API
  description: >-
    Public API for accessing Cevoid user-generated content and loyalty data. Use
    this API to retrieve posts, members, markets, and other data from your
    Cevoid account.
  contact:
    name: Cevoid Support
    url: https://cevoid.com/support
    email: support@cevoid.com
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: https://api.cevoid.com
    description: Production server
  - url: http://localhost:3001
    description: Development server
security:
  - ApiKeyAuth: []
tags:
  - name: Posts
    description: User-generated content posts operations
  - name: Members
    description: Loyalty program members operations
  - name: Markets
    description: Market and localization operations
paths:
  /v1/markets/{id}:
    get:
      tags:
        - Markets
      summary: Get market by ID
      description: Retrieve a specific market by its ID or shortId
      parameters:
        - schema:
            type: string
            description: Market ID or shortId
            example: us
          required: true
          description: Market ID or shortId
          name: id
          in: path
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedResponse'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketNotFoundResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerErrorResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    MarketResponse:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the market within the Cevoid system
          example: market_us_123abc
        shortId:
          type: string
          description: >-
            Shortened, human-readable identifier for the market, typically used
            in URLs and API calls
          example: us
        title:
          type: string
          description: >-
            Display name of the market, typically representing the country or
            region
          example: United States
        customId:
          type: string
          description: Custom identifier for the market, alternative to shortId
          example: us-market
        country:
          type: string
          description: >-
            ISO 3166-1 alpha-2 country code representing the geographic market
            location
          example: US
        currency:
          type: string
          description: >-
            ISO 4217 currency code used for pricing and transactions within this
            market
          example: USD
        language:
          type: string
          description: >-
            ISO 639-1 language code representing the primary language for
            content and communications in this market
          example: en
        domain:
          type: string
          description: >-
            Primary domain URL or website associated with this market, used for
            e-commerce store integration
          example: https://store.example.com
        default:
          type: boolean
          description: >-
            Indicates whether this market serves as the default/fallback market
            when no specific market is selected
          example: true
        settings:
          nullable: true
          description: Market-specific configuration and settings object
          example: {}
        createdAt:
          type: string
          description: >-
            ISO 8601 timestamp indicating when this market was first created in
            the system
          example: '2024-01-10T08:00:00.000Z'
        updatedAt:
          type: string
          description: ISO 8601 timestamp indicating when this market was last updated
          example: '2024-01-15T12:45:30.000Z'
      required:
        - id
        - shortId
        - title
        - country
        - currency
        - language
        - domain
        - default
        - createdAt
        - updatedAt
    ErrorResponse:
      type: string
    UnauthorizedResponse:
      type: string
      enum:
        - No valid API key provided
    MarketNotFoundResponse:
      type: string
      enum:
        - Could not find market
    InternalServerErrorResponse:
      type: string
      enum:
        - Something went wrong
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````