---
title: "List Owners"
method: GET
path: "/api/v3/crm/{integration_id}/owners"
tags: ["CRM Owners"]
---

# List Owners

`GET /api/v3/crm/{integration_id}/owners`

Get a paginated list of owners from the CRM.

Owners are users in your CRM account who can be assigned to CRM records
(contacts, companies, deals, tasks, etc.). Use this endpoint to populate
owner dropdowns in your UI for assignment purposes.

**Pagination:**
Use the `nextCursor` value in subsequent requests to fetch more results.

**Filtering:**
- Use `email` to find a specific owner by email address
- Use `archived` to include archived (deactivated) owners

## Path parameters

- `integration_id` string, uuid, required — The CRM integration ID

## Query parameters

- `limit` integer — Number of results per page (max 100)
- `after` string, nullable — Pagination cursor
- `email` string, nullable — Filter by email address (exact match)
- `archived` boolean — Include archived owners

## Response `200`

Successful Response

- OwnerListResponse — API response for listing owners.
  - `results` OwnerResponse[], required
    - `id` string, required — The CRM owner ID
    - `email` string, nullable — Owner's email address
    - `firstName` string, nullable — Owner's first name
    - `lastName` string, nullable — Owner's last name
    - `full_name` string, required — Owner's full name (computed)
    - `userId` integer, nullable — CRM user ID
    - `createdAt` string, nullable — When the owner was created
    - `updatedAt` string, nullable — When the owner was last updated
    - `archived` boolean — Whether the owner is archived
    - `teams` TeamResponse[] — Teams the owner belongs to
      - `id` string, required
      - `name` string, required
      - `primary` boolean, required — Whether this is the owner's primary team
  - `has_more` boolean — Whether there are more results to fetch
  - `nextCursor` string, nullable — Cursor for fetching next page
  - `total` integer, required — Number of owners in this response

## Other responses

- `422` — Validation Error

---

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