---
title: "List projects in a market (paged)."
url: "https://developer.argaam.com/apis/projects-capital-investments-layer-api-sandbox-v1/versions/e21211e4-e4a7-4273-a6ff-f45e533a0e17/operations/getProjectsByMarketByMarketId"
---

> Full API specification: https://developer.argaam.com/apis/projects-capital-investments-layer-api-sandbox-v1/versions/e21211e4-e4a7-4273-a6ff-f45e533a0e17.md

# List projects in a market (paged).

`GET` `/api/v1.1/projects/by-market/{marketId}`

Operation ID: `getProjectsByMarketByMarketId`

Returns active and recently completed projects in the requested market. Useful for building **regional project pipelines** dashboards. ### Example ``` GET /api/v1.1/projects/by-market/1?page=1&pageSize=20 ```

## Path parameters

- `marketId` (integer, int32, required) - Market ID.

## Query parameters

- `page` (integer, int32, optional) - 1-based page number. Default: `1`. Defaults to `1`.
- `pageSize` (integer, int32, optional) - Records per page. Default: `10`. Defaults to `10`.

## Responses

- `200` - Success

## OpenAPI definition

````yaml
openapi: 3.0.1
info:
  title: Projects & Capital Investments Layer API
  version: v1.1
servers:
  - url: https://api-sandbox.argaam.com
    description: Argaam API Gateway (Sandbox)
paths:
  /api/v1.1/projects/by-market/{marketId}:
    get:
      tags:
        - Projects
      parameters:
        - name: marketId
          in: path
          required: true
          schema:
            type: integer
            format: int32
          description: Market ID.
          example: 3
        - name: page
          in: query
          description: "1-based page number. Default: `1`. Defaults to `1`."
          schema:
            type: integer
            format: int32
            default: 1
          example: 1
        - name: pageSize
          in: query
          description: "Records per page. Default: `10`. Defaults to `10`."
          schema:
            type: integer
            format: int32
            default: 10
          example: 20
      responses:
        "200":
          description: Success
      summary: List projects in a market (paged).
      description: "Returns active and recently completed projects in the\r

        requested market. Useful for building **regional project\r

        pipelines** dashboards.\r

        \            \r

        ### Example\r

        ```\r

        GET /api/v1.1/projects/by-market/1?page=1&pageSize=20\r

        ```"
      operationId: getProjectsByMarketByMarketId
security:
  - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
````