> ## 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 markets

> Retrieve all available markets for the company



## OpenAPI

````yaml https://api.cevoid.com/v1/openapi.json get /v1/markets
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:
    get:
      tags:
        - Markets
      summary: Get markets
      description: Retrieve all available markets for the company
      parameters:
        - schema:
            type: number
            minimum: 1
            maximum: 25
            default: 25
            description: Max value for limit is 25
            example: 10
          required: false
          description: Max value for limit is 25
          name: limit
          in: query
        - schema:
            type: number
            nullable: true
            minimum: 0
            default: 0
            description: Number of items to skip
            example: 0
          required: false
          description: Number of items to skip
          name: skip
          in: query
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketsResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerErrorResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    MarketsResponse:
      type: object
      properties:
        count:
          type: number
          description: Total number of items
        next:
          type: string
          nullable: true
          description: URL for next page
        nodes:
          type: array
          items:
            $ref: '#/components/schemas/Market'
      required:
        - count
        - next
        - nodes
    ErrorResponse:
      type: string
    UnauthorizedResponse:
      type: string
      enum:
        - No valid API key provided
    InternalServerErrorResponse:
      type: string
      enum:
        - Something went wrong
    Market:
      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
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````