---
title: "Read a requester"
method: GET
path: "/products/help-desk/requesters/{requester_id}"
tags: ["help-desk"]
---

# Read a requester

`GET /products/help-desk/requesters/{requester_id}`

## Request

- Base URL: `https://api.sparkvault.com/v1`
- URL: `https://api.sparkvault.com/v1/products/help-desk/requesters/{requester_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sparkvault/apis/sparkvault-api/docs/products/help-desk/requesters/:requester_id/get.ts> (a function with typed inputs; its response is checked against the schema)

A requester of the desk, their address and name opened: how they last proved their address, how many requests they have made, and their block while it stands. An erased requester names no address and no name. Any member, from their own session; the desk must be active, since what it keeps sealed opens only through its vault.

## Path parameters

- `requester_id` string, required

## Response `200`

The requester.

- object
  - `data` HelpDeskRequesterDetails, required: A requester as an operator reads them, their address and name opened.
    - `requester_id` string, required
    - `email` string, nullable, required: Their address; null once they are erased.
    - `display_name` string, nullable, required: The name they gave; null until they give one, and once they are erased.
    - `assurance` 'identity' | 'email_pin', required: How they last proved their address: Secure Identity, or an emailed code.
    - `ticket_count` integer, required: The requests they have made.
    - `blocked` object: Present while they are blocked.
      - `at` integer, required
      - `by` string, nullable, required: The admin who blocked them.
      - `reason` string, nullable, required: The admin's note, if any.
    - `erased_at` integer: When their data was erased; present only once it is.
  - `meta` ResponseMeta: Envelope metadata present on every successful response.
    - `api_version` string
    - `request_id` string
    - `response_ms` integer
    - `timestamp` integer: Unix seconds.
    - `pools` object: Storage and bandwidth capacity snapshot for the account.
    - `billing` object
      - `past_due` boolean
    - `quota` object: This minute of the account request budget. Present on authenticated success responses that passed the throttle; absent otherwise.
      - `limit` integer
      - `used` integer
      - `remaining` integer
      - `resets_at` integer: Unix seconds.

## Other responses

- `401`: AUTHENTICATION_ERROR — missing or invalid credentials.
- `403`: FORBIDDEN — the credential is an API key or an impersonated session: the help desk is worked from a member's own session. HELP_DESK_SUBSCRIPTION_REQUIRED — a change that needs the help desk, on an organization that does not hold it.
- `404`: NOT_FOUND — the desk holds no such requester.
- `409`: HELP_DESK_NOT_ACTIVE — the desk is not active.

## Changes

- **2026-10-28** `a9a10e328ba5`: 16 info
  - the response property `error/details` became required for the status `401`
  - the response property `error/details` became required for the status `403`
  - the response property `error/details` became required for the status `404`
  - the response property `error/details` became required for the status `409`
  - …12 more
- **2026-10-28** `56d7c265a77a`: 4 breaking
  - the response property `error/details` became nullable for the status `401`
  - the response property `error/details` became nullable for the status `403`
  - the response property `error/details` became nullable for the status `404`
  - the response property `error/details` became nullable for the status `409`
- **2026-10-23** `ad4c62db5e08`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sparkvault/apis/sparkvault-api/changes/products/help-desk/requesters/:requester_id/get.md)

---

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