---
title: "List Projects"
method: GET
path: "/projects"
tags: ["Projects"]
---

# List Projects

`GET /projects`

## Query parameters

- `page` integer
- `per_page` integer
- `query` string
- `modified_since` string

## Response `200`

List of projects sorted by most recent activity first

- Project[]
  - `id` string, required — A unique identifier for the Project.
  - `company_id` string — A unique identifier for the Company the Project belongs to
  - `creator_id` string — The id of the entity that created the Project
  - `creator_type` string — The type of the entity that created the Project
  - `creator_name` string — The display name of the entity that created the Project
  - `status` 'active' | 'deleted' — Indicates the status of the Project.
  - `archived` boolean — Indicates whether the Project is archived
  - `name` string, nullable — The title of the Project
  - `address` Address
    - `street_address_1` string, nullable
    - `street_address_2` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `postal_code` string, nullable
    - `country` string, nullable
  - `coordinates` Coordinate
    - `lat` number, float, required
    - `lon` number, float, required
  - `featured_image` ImageURI[] — A list of images for the different variants of the Project’s feature image.
    - `type` string, required
    - `uri` string, required
    - `url` string
  - `project_url` string — The URL to the Project in the web app
  - `embedded_project_url` string — The URL to an embeddable photo feed for the Project
  - `integrations` ProjectIntegration[] — A list of integrations associated with the Project
    - `type` string, required
    - `relation_id` string, required
  - `slug` string — A unique identifier use the Project that is used to construct some public URLs
  - `public` boolean — Indicates whether the Project’s timeline and other public features are enabled
  - `geofence` Coordinate[] — The Geofence latitude and longitude
    - `lat` number, float, required
    - `lon` number, float, required
  - `primary_contact` ProjectContactResponse
    - `id` string — The unique ID of the project contact
    - `project_id` string — The unique ID of the project the contact is attached to
    - `name` string — The name of the contact
    - `email` string — The email of the contact
    - `phone_number` string — The phone of the contact
    - `created_at` integer — Timestamp when the Project Contact was created on the server
    - `updated_at` integer — Timestamp when the Project Contact was last updated
  - `notepad` string — Notes or description of the project
  - `created_at` integer — Timestamp when the Project was created
  - `updated_at` integer — Timestamp when the Project was updated

## Other responses

- `400` — Bad Request
- `404` — Not found
- `500` — Unexpected error

---

[API](https://skmtc.net/companycam/apis/core-api.md) · [All operations](https://skmtc.net/companycam/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/companycam/core-api/versions/f2cd76b46603/schema)