---
title: "List owners"
method: GET
path: "/crm/owners/2026-09"
tags: ["Basic"]
---

# List owners

`GET /crm/owners/2026-09`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/owners/2026-09`
- 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`

Retrieve a paginated list of owners from your HubSpot account. This endpoint allows filtering by email and supports pagination through the 'after' parameter. You can also specify the maximum number of results per page and choose to include archived owners in the response.

## 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 string token used as a cursor for pagination, indicating the position after the last item on the current page.
      - `link` string: A string containing the URL link to the next page of results.
  - `results` PublicOwner[], required: An array of PublicOwner objects, each representing an individual owner with their specific details.
    - `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[]: An array of teams associated with the owner, where each team is represented by a PublicTeam object.
      - `id` string, required: The unique identifier for the team, represented as a string.
      - `name` string, required: The name of the team, represented as a string.
      - `primary` boolean, required: A boolean indicating whether this team is the primary team.
    - `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-11-16** (2026-09) `329a9dbd3836`: 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** (2026-09) `8d7218c5d05b`: 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-10-10** (2026-09) `f7bd5bb7859a`: 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-10** (2026-09) `f7bd5bb7859a`: 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-03** (2026-09) `e8c5805fb83a`: 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`

[Operation history](https://skmtc.dev/hubspot/apis/crm-crm-owners/changes/crm/owners/2026-09/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/329a9dbd3836?raw)
