---
title: "Search Users In Notifications"
method: GET
path: "/api/{account}/notifications/search-users"
tags: ["Notifications"]
---

# Search Users In Notifications

`GET /api/{account}/notifications/search-users`

Search users that have appeared in your notifications

## Query parameters

- `query` string, required — The query to search for. Can be either a name or username.

## Response `200`

Success

- object
  - `data` object[]
    - `view` string
    - `avatar` string, nullable
    - `avatarThumbs` string, nullable
    - `header` string, nullable
    - `headerSize` string, nullable
    - `headerThumbs` string, nullable
    - `id` integer
    - `name` string
    - `username` string
    - `canLookStory` boolean
    - `canCommentStory` boolean
    - `hasNotViewedStory` boolean
    - `isVerified` boolean
    - `canPayInternal` boolean
    - `hasScheduledStream` boolean
    - `hasStream` boolean
    - `hasStories` boolean
    - `tipsEnabled` boolean
    - `tipsTextEnabled` boolean
    - `tipsMin` integer
    - `tipsMinInternal` integer
    - `tipsMax` integer
    - `canEarn` boolean
    - `canAddSubscriber` boolean
    - `subscribePrice` integer
    - `displayName` string
    - `notice` string
    - `isRestricted` boolean
    - `canRestrict` boolean
    - `subscribedBy` boolean
    - `subscribedByExpire` boolean
    - `subscribedByExpireDate` string
    - `subscribedByAutoprolong` boolean
    - `subscribedIsExpiredNow` boolean
    - `currentSubscribePrice` integer
    - `subscribedOn` boolean
    - `subscribedOnExpiredNow` boolean
    - `subscribedOnDuration` string
    - `listsStates` object[]
      - `id` string
      - `type` string
      - `name` string
      - `hasUser` boolean
      - `canAddUser` boolean
      - `cannotAddUserReason` string
    - `canReport` boolean
    - `canReceiveChatMessage` boolean
    - `hideChat` boolean
    - `lastSeen` string
    - `isPerformer` boolean
    - `isRealPerformer` boolean
    - `subscribedByData` object
      - `price` integer
      - `newPrice` integer
      - `regularPrice` integer
      - `subscribePrice` integer
      - `discountPercent` integer
      - `discountPeriod` integer
      - `subscribeAt` string
      - `expiredAt` string
      - `renewedAt` string
      - `discountFinishedAt` string, nullable
      - `discountStartedAt` string, nullable
      - `status` string, nullable
      - `isMuted` boolean
      - `unsubscribeReason` string
      - `duration` string
      - `showPostsInFeed` boolean
      - `subscribes` object[]
        - `id` integer
        - `userId` integer
        - `subscriberId` integer
        - `date` string
        - `duration` integer
        - `startDate` string
        - `expireDate` string
        - `cancelDate` string, nullable
        - `price` integer
        - `regularPrice` integer
        - `discount` integer
        - `earningId` integer
        - `action` string
        - `type` string
        - `offerStart` string, nullable
        - `offerEnd` string, nullable
        - `isCurrent` boolean
      - `hasActivePaidSubscriptions` boolean
    - `subscribedOnData` object
      - `price` integer
      - `newPrice` integer
      - `regularPrice` integer
      - `subscribePrice` integer
      - `discountPercent` integer
      - `discountPeriod` integer
      - `subscribeAt` string
      - `expiredAt` string
      - `renewedAt` string
      - `discountFinishedAt` string, nullable
      - `discountStartedAt` string, nullable
      - `status` string, nullable
      - `isMuted` boolean
      - `unsubscribeReason` string
      - `duration` string
      - `tipsSumm` integer
      - `subscribesSumm` integer
      - `messagesSumm` integer
      - `postsSumm` integer
      - `streamsSumm` integer
      - `totalSumm` integer
      - `lastActivity` string
      - `recommendations` integer
      - `subscribes` object[]
        - `id` integer
        - `userId` integer
        - `subscriberId` integer
        - `date` string
        - `duration` integer
        - `startDate` string
        - `expireDate` string
        - `cancelDate` string, nullable
        - `price` integer
        - `regularPrice` integer
        - `discount` integer
        - `earningId` integer
        - `action` string
        - `type` string
        - `offerStart` string
        - `offerEnd` string
        - `isCurrent` boolean
      - `hasActivePaidSubscriptions` boolean
    - `canTrialSend` boolean
    - `isBlocked` boolean
    - `promoOffers` unknown[]
      - unknown
    - `canUnsubscribe` boolean
    - `isPendingAutoprolong` boolean
  - `_meta` object
    - `_credits` object
      - `used` integer
      - `balance` integer
      - `note` string
    - `_cache` object
      - `is_cached` boolean
      - `note` string
    - `_rate_limits` object
      - `limit_minute` integer
      - `limit_day` integer
      - `remaining_minute` integer
      - `remaining_day` integer

---

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