---
title: "List users"
method: GET
path: "/v1/connect/{project_id}/users"
---

# List users

`GET /v1/connect/{project_id}/users`

Retrieve all external users for the project

## Query parameters

- `after` string
- `before` string
- `limit` integer
- `q` string

## Headers

- `x-pd-environment` 'development' | 'production', required — The environment in which the server client is running

## Response `200`

users listed

- GetUsersResponse
  - `data` ExternalUser[], required
    - `id` string, required — The external user's Pipedream ID
    - `external_id` string, required — Your identifier for the external user
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `page_info` PageInfo, required
    - `count` integer — Number of items returned
    - `total_count` integer — Total number of items
    - `start_cursor` string, nullable — Used to fetch the previous page of items
    - `end_cursor` string, nullable — Used to fetch the next page of items

## Other responses

- `429` — too many requests

---

[API](https://skmtc.net/pipedream/apis/pipedream-rest-api.md) · [All operations](https://skmtc.net/pipedream/apis/pipedream-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pipedream/pipedream-rest-api/versions/c25dbf225c49/schema)