---
title: "Search Grant Feed"
method: POST
path: "/api/v1/grants/feed"
tags: ["App Entitlement User Binding Feed"]
---

# Search Grant Feed

`POST /api/v1/grants/feed`

Search a chronological feed of grant and revoke events, filtered by app user, entitlement, or time range.

## Request body

- C1ApiAppV1SearchGrantFeedRequest — The SearchGrantFeedRequest message.
  - `after` string, date-time
  - `appEntitlementRefs` C1ApiAppV1AppEntitlementRef[], nullable — The list of app entitlements to limit the search to.
    - `appId` string — The appId field.
    - `id` string — The id field.
  - `appRefs` C1ApiAppV1AppRef[], nullable — The list of apps to limit the search to.
    - `id` string — The id field.
  - `appUserRefs` C1ApiAppV1AppUserRef[], nullable — The list of app users to limit the search to.
    - `appId` string — The ID of the application.
    - `id` string — The ID of the app user.
  - `before` string, date-time
  - `expandMask` C1ApiAppV1AppEntitlementUserBindingExpandHistoryMask — The AppEntitlementUserBindingExpandHistoryMask message.
    - `paths` string[], nullable — The paths field.
  - `pageSize` integer — The pageSize where 10 <= pageSize <= 100, default 25.
  - `pageToken` string — The page_token field for pagination.
  - `userRefs` C1ApiUserV1UserRef[], nullable — The list of C1 users to limit the search to.
    - `id` string — The id of the user.

## Response `200`

The SearchGrantFeedResponse message contains a list of grant event results and a nextPageToken if applicable.

- C1ApiAppV1SearchGrantFeedResponse — The SearchGrantFeedResponse message contains a list of grant event results and a nextPageToken if applicable.
  - `expanded` object[], nullable — The expanded field.
    - `@type` string — The type of the serialized message.
  - `list` C1ApiAppV1AppEntitlementUserBindingFeedView[], nullable — The list of results containing up to X results, where X is the page size defined in the request.
    - `appPath` string — The appPath field.
    - `appUserPath` string — The appUserPath field.
    - `entitlementPath` string — The entitlementPath field.
    - `feed` C1ApiAppV1AppEntitlementUserBindingFeed — The AppEntitlementUserBindingFeed message.
      - `appEntitlementId` string — The ID of the app entitlement that the app user has access to
      - `appId` string — The ID of the app associated with the app entitlement
      - `appUserId` string — The ID of the app user that has access to the app entitlement
      - `date` string, date-time
      - `eventType` 'GRANT_EVENT_TYPE_UNSPECIFIED' | 'GRANT_EVENT_TYPE_ADDED' | 'GRANT_EVENT_TYPE_REMOVED' — The eventType field.
      - `ticketId` string — The ticketId field.
    - `ticketPath` string — The ticketPath field.
  - `nextPageToken` string — The nextPageToken is shown for the next page if the number of results is larger than the max page size. The server returns one page of results and the nextPageToken until all results are retrieved. To retrieve the next page, use the same request and append a pageToken field with the value of nextPageToken shown on the previous page.

---

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