---
title: "Get engagements for a given company"
method: GET
path: "/v1/companies/{uuid}/engagements"
tags: ["companies", "engagements"]
---

# Get engagements for a given company

`GET /v1/companies/{uuid}/engagements`

## Path parameters

- `uuid` string, uuid, required

## Query parameters

- `page` number, nullable
- `per_page` number, nullable
- `sort_order` 'asc' | 'desc'

## Response `200`

The Engagements for the specified Company

- object
  - `data` EngagementRead[], required
    - `uuid` string, uuid, required
    - `name` string, required
    - `status` 'Pending' | 'In Progress' | 'Complete' | 'Archived', required — The engagement's current lifecycle status.
    - `is_template` boolean, required — Whether this is a reusable engagement template rather than a live engagement.
    - `company_uuid` string, uuid, required — UUID of the client company this engagement is for.
    - `start_date` string, date, nullable, required — The engagement's planned start date, or null if not scheduled.
    - `end_date` string, date, nullable, required — The engagement's planned end date, or null if not scheduled.
    - `created_at` string, date-time, required
    - `report_issue_date` string, date, nullable, required — The date the audit report was issued, or null if not yet issued.
    - `engagement_lead_user_uuid` string, uuid, nullable, required — UUID of the user leading the engagement (the audit lead), or null if no engagement lead is available.
    - `client_owner_user_uuid` string, uuid, nullable, required — UUID of the client-side owner of the engagement, or null if unassigned.
    - `identifier` string, nullable — An external identifier that can be used by integrated systems
    - `_links` EngagementReadLinks, required
      - `fieldguide` HalLink, required
        - `href` string, uri, required
        - `title` string — A human-readable title for the link
        - `type` string, required — The content-type
  - `_links` object, required
    - `self` object, required — The URL for the current page being fetched
      - `href` string
    - `first` object, required — The URL for the first page of the set
      - `href` string
    - `last` object, required — The URL for the last page of the set
      - `href` string
    - `previous` object — The URL for the previous page in the set, if there is one
      - `href` string
    - `next` object — The URL for the next page in the set, if there is one
      - `href` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden (requires scopes `engagements:read`)
- `429` — Too many requests

---

[API](https://skmtc.net/fieldguide/apis/fieldguide-api.md) · [All operations](https://skmtc.net/fieldguide/apis/fieldguide-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fieldguide/fieldguide-api/revisions/6f6009a58cdd/schema)