---
title: "Get a User"
method: GET
path: "/users/{userId}"
tags: ["User Tagging"]
---

# Get a User

`GET /users/{userId}`

<strong style="color:red;">This endpoint runs on data sent to the Transaction Enrichment endpoints. Tagging is run in batches twice daily and thus not available immediately after posting transactions. Also, in order to receive user tags, transaction dates must be within the past 90 days.</strong>
<br/>
<br />
Fetches user and transaction tags for a specified user ID. Both endpoints return the same schema. Use the sync keyword to trigger a manual update on the transaction and user tags for a single user.

## Path parameters

- `userId` string, required

## Headers

- `include_tagged_transactions` string — This field has been deprecated. Tagged transactions are received automatically from the enrichment API. Set to true to include all of the user's tagged transactions in the response. By default, tagged transactions are not included.

## Response `200`

Success

- object
  - `user` object, required
    - `client_id` string — Your client ID.
    - `id` string — The user ID.
    - `uid` string, required — The user's ID.
    - `uniqueId` string — The user's unique ID in the format of `client_id:uid`.
    - `lifetimeSavings` number — The user's lifetime savings, if known.
    - `registrationDate` string, date-time — The date on which the user was registered with FinSight API.
    - `subtenantId` string — The user's subtenant ID.
    - `tags` string[] — The FinSight API tags that were applied to the user.
    - `totaltransactions` number — The total number of transactions the user has in FinSight API.
    - `transactionsSinceLastUpdate` number — The number of transactions since the last time insights were run for the user.
  - `transactions` object[]
    - `transaction_id` string — The ID of the transaction.
    - `simple_description` string — A human-readable, simplified description for the transaction.
    - `original_description` string — The originally-submitted description of the transaction.
    - `category` string — The category of the transaction.
    - `amount` number — The transaction's amount in USD.
    - `date` string, date-time — The date of the transaction.
    - `tags` string[]

## Other responses

- `401` — Unauthorized
- `404` — User ID could not be found

---

[API](https://skmtc.dev/fingoal/apis/insights-api.md) · [All operations](https://skmtc.dev/fingoal/apis/insights-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fingoal/insights-api/revisions/00cf4dbd5441/schema)