---
title: "List every help request with who sent it (admin)"
method: GET
path: "/api/admin/help-requests"
---

# List every help request with who sent it (admin)

`GET /api/admin/help-requests`

## Request

- Base URL: `https://www.toma.com`
- URL: `https://www.toma.com/api/admin/help-requests`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `better-auth.session_token`

Toma staff only (a verified @toma.so or @toma.com address). Newest first. Same as the list_help_requests MCP tool.

## Query parameters

- `offset` integer: Requests to skip: the nextOffset of the previous page. Default 0.
- `limit` integer: Requests to return. Default 50.

## Response `200`

One page of help requests.

- object
  - `helpRequests` SubmittedHelpRequest[], required
    - `id` string, required
    - `topic` 'refund' | 'chargeback' | 'payment' | 'payout' | 'account' | 'question' | 'other', required
    - `message` string, required
    - `taskId` string, nullable, required
    - `applicationId` string, nullable, required
    - `status` 'open' | 'closed', required
    - `createdAt` string, date-time, required
    - `user` object, required
      - `id` string, required
      - `name` string, required
      - `email` string, required
  - `nextOffset` integer, nullable, required

## Other responses

- `400`: offset or limit is out of range.
- `401`: No valid session or API key.
- `403`: Not Toma staff.

---

[API](https://skmtc.dev/toma/apis/toma-api.md) - [All operations](https://skmtc.dev/toma/apis/toma-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toma/apis/toma-api/revisions/b4e56e1db5a2?raw)