Skip to main content
Retrieve every API project that belongs to your organization. The response includes each project’s current status, runtime health, and timestamps, giving you a full snapshot of your project inventory in a single call.

​
Authentication

Include your API key as Authorization: Bearer YOUR_API_KEY in the request headers.

​
Endpoint

GET https://plangrep.com/api/open/v1/projects
This endpoint accepts no path parameters, query parameters, or request body.

​
Example Request

curl --request GET \
  --url https://plangrep.com/api/open/v1/projects \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Accept: application/json"

​
Response Fields

​
projects
Project[]
required
Array of all API projects visible to the authenticated organization.

​
Example Response

{
  "projects": [
    {
      "id": "proj_01hx9z4kqr8e7m3p5n6w2v0abc",
      "name": "Downtown Office Tower",
      "projectKind": "open_api",
      "status": "ready",
      "runtime": {
        "status": "running",
        "upgradeStatus": "none"
      },
      "createdAt": "2024-11-01T14:22:10.000Z",
      "updatedAt": "2024-11-01T14:24:05.000Z"
    }
  ]
}
Only projects associated with the organization that owns the API key are returned. Projects from other organizations are never included, even if you have been granted access through other Plangrep interfaces.