---
title: "Get the corporate event calendar for a market."
url: "https://developer.argaam.com/apis/news-editorial-layer-api-production-v1/versions/ab3ee138-9ff0-43e3-bb36-91df10612a3e/operations/getMarketsByMarketIdEvents"
---

> Full API specification: https://developer.argaam.com/apis/news-editorial-layer-api-production-v1/versions/ab3ee138-9ff0-43e3-bb36-91df10612a3e.md

# Get the corporate event calendar for a market.

`GET` `/api/v1.1/markets/{marketId}/events`

Operation ID: `getMarketsByMarketIdEvents`

Returns upcoming and recently completed corporate events for all companies in the specified market, including: - Annual / Extraordinary General Meetings (AGM / EGM) - Dividend announcements and payment dates - Earnings releases and financial results - Investor-day and conference dates Events are returned in reverse-chronological order (newest first). **Tip:** For a single company's events use `GET /companies/{companyId}/events`.

## Path parameters

- `marketId` (integer, int32, required) - Market ID (e.g. `1` for Saudi Tadawul).

## Responses

- `200` - Success

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: News & Editorial Layer API
  version: v1.1
servers:
  - url: https://api.argaam.com
    description: Argaam API Gateway (Production)
paths:
  /api/v1.1/markets/{marketId}/events:
    get:
      tags:
        - Markets
      parameters:
        - name: marketId
          in: path
          required: true
          schema:
            type: integer
            format: int32
          description: Market ID (e.g. `1` for Saudi Tadawul).
          example: 3
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiV1Response"
      summary: Get the corporate event calendar for a market.
      description: "Returns upcoming and recently completed corporate events for all\r

        companies in the specified market, including:\r

        \            \r

        - Annual / Extraordinary General Meetings (AGM / EGM)\r

        - Dividend announcements and payment dates\r

        - Earnings releases and financial results\r

        - Investor-day and conference dates\r

        \            \r

        Events are returned in reverse-chronological order (newest first).\r

        \                   \r

        **Tip:** For a single company's events use\r

        `GET /companies/{companyId}/events`."
      operationId: getMarketsByMarketIdEvents
security:
  - ApiKeyAuth: []
components:
  schemas:
    ApiV1Response:
      type: object
      properties:
        success:
          type: boolean
        apiVersion:
          type: string
          nullable: true
        timestamp:
          type: string
          format: date-time
        requestId:
          type: string
          nullable: true
        data:
          nullable: true
        meta:
          $ref: "#/components/schemas/ApiV1Meta"
        rateLimit:
          $ref: "#/components/schemas/ApiV1RateLimit"
      additionalProperties: false
    ApiV1Meta:
      type: object
      properties:
        page:
          type: integer
          format: int32
        pageSize:
          type: integer
          format: int32
        totalRecords:
          type: integer
          format: int32
        totalPages:
          type: integer
          format: int32
          readOnly: true
        hasNextPage:
          type: boolean
          readOnly: true
        hasPreviousPage:
          type: boolean
          readOnly: true
      additionalProperties: false
    ApiV1RateLimit:
      type: object
      properties:
        limit:
          type: integer
          format: int32
        remaining:
          type: integer
          format: int32
        reset:
          type: string
          format: date-time
      additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
```