---
title: "Get budget member details"
method: GET
path: "/v3/spend/budgets/{budgetId}/members/{userId}"
tags: ["budgets"]
---

# Get budget member details

`GET /v3/spend/budgets/{budgetId}/members/{userId}`

## Request

- Base URL: `https://gateway.stage.bill.com/connect`
- URL: `https://gateway.stage.bill.com/connect/v3/spend/budgets/{budgetId}/members/{userId}`
- Auth: none declared

Get details about a user member assigned to an existing budget.

## Path parameters

- `budgetId` string, required: BILL-generated ID or UUID of the budget
- `userId` string, required: BILL-generated ID or UUID of the user

## Headers

- `apiToken` string, nullable: Access token for Spend & Expense API authentication

## Response `200`

Get budget member details response

- BudgetMemberResponseDto: Budget members response.
  - `userId` string: BILL-generated ID of the user
  - `userUuid` string: BILL-generated UUID of the user
  - `spent` number: Total amount spent by the user in the current budget period
  - `limit` number: Funds assigned to the user in the current budget period
  - `recurringLimit` number: Funds assigned to the user in all future budget periods
  - `recurring` boolean: Set as `true` if the user receives the `recurringLimit` funds in all future budget periods.
  - `budgetRole` 'MEMBER' | 'OWNER' | 'OBSERVER': Budget user role
  - `name` string: User display name
  - `retired` boolean: Set as `true` if the budget member is retired
  - `shareBudgetFunds` boolean: Set as `true` if all the budget funds are shared with the user

## Other responses

- `4XX`: List of errors.
- `5XX`: List of errors.

---

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