---
title: "Returns a list of agents"
method: GET
path: "/agents_cursor"
tags: ["agent"]
---

# Returns a list of agents

`GET /agents_cursor`

Returns the list of agents that the provided key has access to.

## Query parameters

- `size` integer
- `cursor` string
- `modified_at_start` string, date-time
- `modified_at_end` string, date-time

## Response `200`

A JSON array of agents in a cursor response

- Agent[]
  - `id` string, required
  - `name` string, required
  - `first_name` string, required
  - `last_name` string, required
  - `mls` string, required
  - `mls_id` string, required
  - `modified_at` string, date-time, required
  - `phone` string
  - `email` string, email
  - `claimed` boolean
  - `claimed_at` boolean
  - `account_id` string
  - `account` Account
    - `id` string, required
    - `first_name` string, required
    - `last_name` string, required
    - `account_state` 'active' | 'deactivating' | 'unlinked', required
    - `activated_at` string, date-time
    - `active_date` string, date-time
    - `agent_ids` string[], required
    - `email` string, email, required

---

[API](https://skmtc.net/zenlist/apis/zenlist-partner-integration-api.md) · [All operations](https://skmtc.net/zenlist/apis/zenlist-partner-integration-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zenlist/zenlist-partner-integration-api/revisions/803c0368dc8e/schema)