Projects & Capital Investments Layer API (Sandbox)

List projects in a market (paged).

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
get
https://api-sandbox.argaam.com/api/v1.1/projects/by-market/{marketId}

Query Parameters

pageinteger(int32)

1-based page number. Default: 1. Defaults to 1.

Default:1

Example:1

pageSizeinteger(int32)

Records per page. Default: 10. Defaults to 10.

Default:10

Example:20

Path Parameters

marketIdinteger(int32)required

Market ID.

Example:3

Response

200

Success

get/api/v1.1/projects/by-market/{marketId}
 
200

Detailed information for a specific project.

Returns the complete project record: scope, parties involved,
budget breakdown, timeline, and milestones.

Example

GET /api/v1.1/projects/45678
get
https://api-sandbox.argaam.com/api/v1.1/projects/{projectId}

Path Parameters

projectIdinteger(int32)required

Project ID.

Response

200

Success

get/api/v1.1/projects/{projectId}
 
200

List projects involving a specific company (paged).

Returns projects where the company appears as client,
contractor, or consultant
. Useful for backlog assessment
in equity research.

Example

GET /api/v1.1/projects/by-company/2222?page=1&pageSize=20
get
https://api-sandbox.argaam.com/api/v1.1/projects/by-company/{stockSymbol}

Query Parameters

pageinteger(int32)

1-based page number. Defaults to 1.

Default:1

Example:1

pageSizeinteger(int32)

Number of records per page. Defaults to the endpoint’s standard page size; large values are capped server-side.

Default:10

Example:20

Path Parameters

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

Response

200

Success

get/api/v1.1/projects/by-company/{stockSymbol}
 
200

ApiV1Meta

object
* Additional properties are NOT allowed.
pageinteger(int32)
pageSizeinteger(int32)
totalRecordsinteger(int32)
totalPagesinteger(int32)read-only
hasNextPagebooleanread-only
hasPreviousPagebooleanread-only
Example

ApiV1RateLimit

object
* Additional properties are NOT allowed.
limitinteger(int32)
remaininginteger(int32)
resetstring(date-time)
Example