List projects

Returns all projects under the authenticated organization, ordered by creation date (newest first).

GET/projects

Authorization

Requires: BearerAuth

Query parameters

limitintegerquerydefault: 20

Maximum number of projects to return (1–100)

statusenum (pending, building, active...)query

Filter by project status

options:pendingbuildingactivefailed

Response

200 — Array of projects

dataobject[]

totalinteger

Total count across all pages

401 — Missing or invalid API key

errorstringrequired

Machine-readable error code (e.g. `invalid_request`, `unauthorized`, `not_found`)

messagestringrequired

Human-readable error description

List projects

curl --request GET \
  --url 'https://api.codivdocs.com/v1/projects' \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "name": "<string>",
      "slug": "<string>",
      "status": "pending",
      "created_at": "2026-04-13T03:23:48.988Z",
      "github_repo": "<string>",
      "custom_domain": "<string>",
      "github_branch": "main",
      "last_deploy_at": "2026-04-13T03:23:48.988Z"
    }
  ],
  "total": 0
}