---
title: "Projects & Capital Investments Layer API"
url: "https://developer.argaam.com/apis/projects-capital-investments-layer-api-production-v1/versions/d438a439-3669-4a5c-998d-f1860877652a"
---

# Projects & Capital Investments Layer API

OpenAPI specification document.

````json
{"openapi":"3.0.1","info":{"title":"Projects & Capital Investments Layer API","description":"Capital projects and investments: projects by market and by company, detailed project records, and company key developments — for backlog and capex analysis.","contact":{"name":"Argaam IT","url":"https://www.argaam.com","email":"developer@argaam.com"},"version":"v1.1"},"paths":{"/api/v1.1/companies/{stockSymbol}/developments":{"get":{"tags":["Companies"],"parameters":[{"name":"stockSymbol","in":"path","required":true,"schema":{"type":"string"},"example":"2222","description":"Tadawul stock symbol of the company, e.g. `2222` (Saudi Aramco)."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get key developments for a company","description":"Returns the key developments for the company identified by `stockSymbol`.","operationId":"getCompaniesByStockSymbolDevelopments"}},"/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\nrequested market. Useful for building **regional project\r\npipelines** dashboards.\r\n            \r\n### Example\r\n```\r\nGET /api/v1.1/projects/by-market/1?page=1&pageSize=20\r\n```","operationId":"getProjectsByMarketByMarketId"}},"/api/v1.1/projects/{projectId}":{"get":{"tags":["Projects"],"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Project ID."}],"responses":{"200":{"description":"Success"}},"summary":"Detailed information for a specific project.","description":"Returns the complete project record: scope, parties involved,\r\nbudget breakdown, timeline, and milestones.\r\n            \r\n### Example\r\n```\r\nGET /api/v1.1/projects/45678\r\n```","operationId":"getProjectsByProjectId"}},"/api/v1.1/projects/by-company/{stockSymbol}":{"get":{"tags":["Projects"],"parameters":[{"name":"stockSymbol","in":"path","required":true,"schema":{"type":"string"},"description":"Tadawul stock symbol of the company, e.g. `2222` (Saudi Aramco)."},{"name":"page","in":"query","schema":{"type":"integer","format":"int32","default":1},"example":1,"description":"1-based page number. Defaults to `1`."},{"name":"pageSize","in":"query","schema":{"type":"integer","format":"int32","default":10},"example":20,"description":"Number of records per page. Defaults to the endpoint's standard page size; large values are capped server-side."}],"responses":{"200":{"description":"Success"}},"summary":"List projects involving a specific company (paged).","description":"Returns projects where the company appears as **client,\r\ncontractor, or consultant**. Useful for backlog assessment\r\nin equity research.\r\n            \r\n### Example\r\n```\r\nGET /api/v1.1/projects/by-company/2222?page=1&pageSize=20\r\n```","operationId":"getProjectsByCompanyByStockSymbol"}}},"components":{"schemas":{"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},"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}},"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apikey"},"ApiKeyAuthQuery":{"type":"apiKey","in":"query","name":"apikey"}}},"security":[{"ApiKeyAuth":[]}],"servers":[{"url":"https://api.argaam.com","description":"Argaam API Gateway (Production)"}]}
````