---
title: "Get"
method: GET
path: "/api/v1/funds/assignments/{user_id}"
tags: ["Fund Assignments"]
---

# Get

`GET /api/v1/funds/assignments/{user_id}`

## Request

- Base URL: `https://example.conductor.one`
- URL: `https://example.conductor.one/api/v1/funds/assignments/{user_id}`
- Auth: HTTP bearer and OAuth 2
  - Client credentials
  - Token URL: `/auth/v1/token`

Get returns one subject's exception: their own limit, any extension
 running on top of it, and any suspension. A subject with no exception is
 not found rather than reported at the tenant default, because no row is
 what "this subject is governed by the layers above" looks like.

## Path parameters

- `user_id` string, required: The userId field.

## Response `200`

Successful response

- C1ApiFundsV1FundAssignmentServiceGetResponse: The FundAssignmentServiceGetResponse message.
  - `assignment` C1ApiFundsV1FundAssignment: FundAssignment is one principal's fund exception as the API renders it.
    - `controls` C1ApiFundsV1SpendControls: SpendControls retains coexisting base, extension and suspension state.
      - `extension` C1ApiFundsV1SpendExtension: SpendExtension replaces the base total temporarily; it is not additive credit.
        - `expiresAt` string, date-time, nullable
        - `limit` C1ApiFundsV1SpendLimit: SpendLimit distinguishes an amount, unlimited tracking and blocked supply. This message contains a oneof named kind. Only a single field of the following list may be set at a time: - unlimited - amount - blocked
          - `amount` C1ApiFundsV1SpendLimitAmount: The SpendLimitAmount message.
            - `money` C1ApiFundsV1Money: Money is a non-negative monetary value used by spending controls.
              - …
          - `blocked` C1ApiFundsV1SpendLimitBlocked: The SpendLimitBlocked message.
          - `unlimited` C1ApiFundsV1SpendLimitUnlimited: The SpendLimitUnlimited message.
        - `reason` string: The reason field.
      - `limit` C1ApiFundsV1SpendLimit: SpendLimit distinguishes an amount, unlimited tracking and blocked supply. This message contains a oneof named kind. Only a single field of the following list may be set at a time: - unlimited - amount - blocked
        - `amount` C1ApiFundsV1SpendLimitAmount: The SpendLimitAmount message.
          - `money` C1ApiFundsV1Money: Money is a non-negative monetary value used by spending controls.
            - `currencyCode` string: ISO 4217 currency code.
            - `nanos` integer: Fractional nano-units, from zero through 999999999.
            - `units` string, int64: Whole currency units. The bound keeps nano-unit conversion within int64.
        - `blocked` C1ApiFundsV1SpendLimitBlocked: The SpendLimitBlocked message.
        - `unlimited` C1ApiFundsV1SpendLimitUnlimited: The SpendLimitUnlimited message.
      - `period` 'PERIOD_KIND_UNSPECIFIED' | 'PERIOD_KIND_DAILY' | 'PERIOD_KIND_WEEKLY' | 'PERIOD_KIND_MONTHLY' | 'PERIOD_KIND_QUARTERLY' | 'PERIOD_KIND_YEARLY': The period field.
      - `suspension` C1ApiFundsV1SpendSuspension: SpendSuspension preserves the underlying controls while refusing new spend.
        - `reason` string: The reason field.
        - `suspendedAt` string, date-time, nullable
    - `createdAt` string, date-time, nullable
    - `tenantId` string: The tenantId field.
    - `updatedAt` string, date-time, nullable
    - `userId` string: Canonical c1.models.user.v2.User id, every UserType.

## Changes

- **2026-10-20** `fe943bedf41b`: 1 breaking, 1 info
  - added `#/components/schemas/c1.api.funds.v1.SpendControls` to the `assignment/oneOf[subschema #1: Fund Assignment]/controls` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/c1.models.funds.v1.SpendControls` from the `assignment/oneOf[subschema #1: Fund Assignment]/controls` response property `oneOf` list for the response status `200`
- **2026-09-01** `f76d07868c0c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/funds/assignments/:user_id/get.md)

---

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