---
title: "Get all pm_groups in project"
method: GET
path: "/api/v3/projects/{project_id}/pm_groups"
tags: ["pm groups"]
---

# Get all pm_groups in project

`GET /api/v3/projects/{project_id}/pm_groups`

## Request

- Base URL: `https://client-api.us.fieldwire.com`
- URL: `https://client-api.us.fieldwire.com/api/v3/projects/{project_id}/pm_groups`
- Auth: HTTP bearer

PM Groups refers to companies.

Please see this for more detail: [https://help.fieldwire.com/hc/en-us/articles/9736608004763-How-to-Enable-PM-and-Manage-Companies-on-a-Project#22](https://help.fieldwire.com/hc/en-us/articles/9736608004763-How-to-Enable-PM-and-Manage-Companies-on-a-Project#22)

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `last_synced_at` string, date-time

## Headers

- `Fieldwire-Version` string, date, required
- `Fieldwire-Filter` 'active' | 'deleted'
- `Fieldwire-Per-Page` integer

## Response `200`

Successful response

- PmGroup[]
  - `id` string, uuid, required: ID of the entity
  - `creator_user_id` integer, required: ID of the user who created this entity
  - `last_editor_user_id` integer, required: ID of the user who most recently edited this entity
  - `project_id` string, uuid, required: ID of the project this entity belongs to
  - `code` string, required: 3-digit nickname for this entity (typically derived from name)
  - `name` string, required: Name of the entity
  - `address` string, nullable: Address of the company
  - `is_lead_company` boolean, required: Indicate if this is a lead company
  - `deleted_at` string, date-time, nullable: Time the server deleted the entity
  - `device_created_at` string, date-time, required: Time when the device created the entity
  - `device_updated_at` string, date-time, required: Time when the device last updated the entity
  - `created_at` string, date-time, required: Time when the server created the entity
  - `resolved_conflict` boolean, nullable, required: Specifies if PUT/PATCH request was rejected - do not store this field!
  - `updated_at` string, date-time, required: Time when the server last updated the entity
  - `users` UserWithProject[], nullable: list of user in the PmGroup
    - `id` integer, required: ID of user
    - `account_id` integer, nullable: ID of the account this user belongs to
    - `invited_by_id` integer, nullable: ID of the user who invited this user to the platform
    - `is_email_deliverable` boolean, required: If email can be delivered to this user
    - `company` string, nullable: Name of the company this user belongs to
    - `company_type` 'ARCHITECT_SLASH_DESIGNER' | 'GENERAL_CONTRACTOR' | 'OWNER' | 'SPECIALTY_CONTRACTOR' | 'OTHER' | 'null', nullable: Type of the company this user belongs to
    - `email` string, required: Email of this user
    - `first_name` string, required: First name of this user
    - `job_title` string, nullable: Title this user holds at their job
    - `language` string, required: Preferred language of this user
    - `last_name` string, required: Last name of this user
    - `phone_number` string, nullable: Phone number of this user
    - `photo_url` string, nullable: URL where the profile picture of this user lives
    - `email_notifications` 'never' | 'daily' | 'instantly' | 'null', nullable: Email notification preference of this user for delivering task updates
    - `sync_scheme` 'smart_cellular' | 'full_cellular', required: Synchronization scheme of this user used by the mobile apps
    - `email_addresses` object[]: Deprecated. Use the "email" property instead
    - `is_confirmed` boolean: Whether the user has accepted the invitation if there was one
    - `created_at` string, date-time, required: Time when the server created this user
    - `current_sign_in_at` string, date-time, nullable: Last time the user was seen online
    - `in_app_purchase_end_at` string, date-time, nullable: When the in app purchase this user made ends
    - `updated_at` string, date-time, required: Time when the server last updated this user
    - `trade_type` 'CONCRETE' | 'EARTHWORK' | 'ELECTRICAL' | 'FIRE_SUPPRESSION' | 'FRAMING_AND_OR_DRYWALL' | 'HVAC' | 'LOW_VOLTAGE' | 'MECHANICAL' | 'PLUMBING' | 'UTILITIES' | 'OTHER' | 'null', nullable: Type of the trade this user's company belongs to
    - `is_approved` boolean, nullable: If this user is approved to be a part of the project
    - `project_id` string, uuid: ID of the project this user belongs to
    - `is_admin` boolean, nullable: If this user is an admin in this project
    - `user_deleted_at` string, date-time, nullable: Time when this user was deleted from this project
    - `user_blocked_at` string, date-time, nullable: Deprected: Time when this user was blocked from accessing this project
    - `role` 'admin' | 'member' | 'follower' | 'null', nullable: Role this user holds in this project

---

[API](https://skmtc.dev/fieldwire/apis/fieldwire-regional-api.md) - [All operations](https://skmtc.dev/fieldwire/apis/fieldwire-regional-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fieldwire/apis/fieldwire-regional-api/revisions/34b820438c0b?raw)