List the people in an automation

The dashboard's People table: each person's name, email, where they are in the automation and how they are doing, newest first, 25 to a page.

GEThttps://app.usenotix.dev/api/v1/automations/{id}/people

Full access and read only keys can call this. Sending access keys cannot. Key permissions lists the extra rules some calls have.

The dashboard's People table: each person's name, email, where they are in the automation and how they are doing, newest first, 25 to a page. Filter by status. Pages go up to 400 (the newest 10,000 people); for more, page the runs by cursor or use the export. A team can read runs and people 60 times a minute, and a read that takes longer than 30 seconds answers 422.

Path parameters

idstringrequired

Query parameters

statusstring

Only runs with this status.

One of ACTIVE, COMPLETED, EXITED, FAILED.

pageinteger

Page number, 1 to 400 (25 people a page, the newest 10,000). For more, page the runs by cursor or use the export.

Minimum 1. Maximum 400. Default 1.

Headers

Authorizationstringrequired

Bearer followed by your API key.

Errors

400

The page is past 400 (the newest 10,000 people), or a filter is not valid.

404

No journey with this id for the calling team (or, for a pinned key, on its domain).

422

The read took longer than 30 seconds.

429

The team read journey runs and people 60 times in the last minute.

Every error has the same shape. See all error codes.

curl -X GET "https://app.usenotix.dev/api/v1/automations/<id>/people" \
  -H "Authorization: Bearer $NOTIX_API_KEY"
Response200
{
  "data": [
    {
      "runId": "cm1x8f3k20001qz7v5b9d2e4a",
      "name": "Acme",
      "email": "customer@example.com",
      "nowAt": "string",
      "startedAt": "2026-10-01T09:00:00Z",
      "status": {
        "label": null,
        "tone": null
      }
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 1
}
Open in ClaudeOpen in ChatGPT