---
title: "GET /crm/v3/owners"
method: GET
path: "/crm/v3/owners"
tags: ["Basic"]
---

# GET /crm/v3/owners

`GET /crm/v3/owners`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/v3/owners`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `automation`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.owners.read`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.pipelines.approval.read`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.pipelines.governance.write`

## Query parameters

- `after` string
- `archived` boolean
- `email` string
- `limit` integer

## Response `200`

successful operation

- CollectionResponsePublicOwnerForwardPaging
  - `paging` ForwardPaging: Paging information for forward-only pagination. Contains the next page reference when more results are available; omitted or empty on the last page.
    - `next` NextPage: Specifies the paging information needed to retrieve the next set of results in a paginated API response
      - `after` string, required: A paging cursor token for retrieving subsequent pages.
      - `link` string: A URL that can be used to retrieve the next page results.
  - `results` PublicOwner[], required
    - `archived` boolean, required: Indicates whether the owner is archived.
    - `createdAt` string, date-time, required: The date and time when the owner was created.
    - `email` string: The email address of the owner.
    - `firstName` string: The first name of the owner.
    - `id` string, required: The unique identifier of the owner.
    - `lastName` string: The last name of the owner.
    - `teams` PublicTeam[]
      - `id` string, required
      - `name` string, required
      - `primary` boolean, required
    - `type` 'PERSON' | 'QUEUE', required: The type of the owner, which can be either PERSON or QUEUE.
    - `updatedAt` string, date-time, required: The date and time when the owner was last updated.
    - `userId` integer: The user ID of the owner.
    - `userIdIncludingInactive` integer: The user ID of the owner, including inactive users.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-10-23** (v3) `e364b33573c9`: 2 info
  - the security scope `automation` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.pipelines.governance.write` was removed from the endpoint's security scheme `oauth2`
- **2026-10-21** (v3) `354d43093879`: 2 info
  - the security scope `automation` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.objects.owners.read` was removed from the endpoint's security scheme `oauth2`
- **2026-09-04** (v3) `63847721bc60`: 2 info
  - the security scope `automation` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.objects.owners.read` was removed from the endpoint's security scheme `oauth2`
- **2026-08-20** (v3) `ce1b5dd1fec2`: 1 info
  - endpoint added
- **2026-07-13** (v3) `4385d7ed98d2`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/hubspot/apis/crm-crm-owners/changes/crm/v3/owners/get.md)

---

[API](https://skmtc.dev/hubspot/apis/crm-crm-owners.md) - [All operations](https://skmtc.dev/hubspot/apis/crm-crm-owners/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/crm-crm-owners/revisions/e364b33573c9?raw)
