---
title: "Search"
method: POST
path: "/api/v1/funds/assignments/search"
tags: ["Fund Assignments"]
---

# Search

`POST /api/v1/funds/assignments/search`

## Request

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

Search the tenant's assignments. Reads the Postgres mirror: the runtime
 row is keyed on (tenant, user), so there is no cross-subject query on the
 runtime plane at all.

## Request body

- C1ApiFundsV1FundAssignmentServiceSearchRequest: The FundAssignmentServiceSearchRequest message.
  - `pageSize` integer: The pageSize field.
  - `pageToken` string: The pageToken field.
  - `userIds` string[], nullable: Restrict to these subjects; empty returns every assignment in the tenant.

## Response `200`

Successful response

- C1ApiFundsV1FundAssignmentServiceSearchResponse: The FundAssignmentServiceSearchResponse message.
  - `list` C1ApiFundsV1FundAssignment[], nullable: The list field.
    - `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.
  - `nextPageToken` string: The nextPageToken field.

## Changes

- **2026-10-20** `fe943bedf41b`: 1 breaking, 1 info
  - added `#/components/schemas/c1.api.funds.v1.SpendControls` to the `list/items/controls` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/c1.models.funds.v1.SpendControls` from the `list/items/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/search/post.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)