Get Groups
get_groupsRetrieve all accessible groups with pagination and filtering, providing company_id and project_id for full group details from the Procore Document Markup API.
Instructions
Returns all accessible groups with pagination and filtering. Use this when you already know which group you want and need its full field set. company_id and project_id default to the values set by procore_set_config when omitted. Returns a single JSON object describing the group. Read-only — it changes nothing in Procore. Failures come back as an error payload carrying the HTTP status — commonly 401 when the token has expired, 403 without tool permission, and 404 when an id does not resolve. Required parameters: company_id, project_id. Procore API (v2.0): Project Management > Document Markup. Endpoint: GET /rest/v2.0/companies/{company_id}/projects/{project_id}/domains/groups
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Query string parameter — page number for pagination (1-based) | |
| per_page | No | Query string parameter — number of items per page (max 5000 for ids_only) | |
| company_id | Yes | URL path parameter — unique identifier of the company | |
| project_id | Yes | URL path parameter — unique identifier of the project | |
| filters__id | No | Query string parameter — jSON array of group IDs to filter by | |
| filters__context_id | No | Query string parameter — context ID to filter groups by | |
| filters__updated_at | No | Query string parameter — filter by updated_at range in ISO format (start...end) | |
| filters__created_before | No | Query string parameter — filter groups created before this ISO date-time | |
| filters__context_type_id | No | Query string parameter — context type ID to filter by | |
| filters__subcontext_type_id | No | Query string parameter — sub-context type ID to filter by |