---
title: "POST /v1/user/query"
method: POST
path: "/v1/user/query"
tags: ["User"]
---

# POST /v1/user/query

`POST /v1/user/query`

## Request body

- UserQueryParams
  - `userIds` string[]
  - `timeFilter` object
    - `endTimeUnixSeconds` number, double, required
    - `startTimeUnixSeconds` number, double, required

## Response `200`

Ok

- union
  - ResultSuccessCountNumberPromptTokensNumberCompletionTokensNumberUserIdStringCostNumberArray
    - `data` object[], required
      - `cost` number, double, required
      - `user_id` string, required
      - `completion_tokens` number, double, required
      - `prompt_tokens` number, double, required
      - `count` number, double, required
    - `error` null, nullable, required
  - ResultErrorString
    - `data` null, nullable, required
    - `error` string, required

---

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