---
title: "List discovered vendors"
method: GET
path: "/discovered-vendors"
tags: ["Discovered Vendors"]
---

# List discovered vendors

`GET /discovered-vendors`

List discovered vendors.

## Query parameters

- `scope` 'NEEDS_REVIEW' | 'IGNORED' | 'REJECTED' — The scope of a discovered vendor. NEEDS_REVIEW: The vendor needs review IGNORED: The vendor was ignored REJECTED: The vendor was rejected
- `pageSize` integer — Controls the maximum number of items returned in one response from the API.
- `pageCursor` string — A marker or pointer, telling the API where to start fetching items for the subsequent page in a paginated dataset. Note that the requested page will not include the item that corresponds to this cursor but will start from the one immediately after this cursor.

## Response `200`

Ok

- PaginatedResponseDiscoveredVendor
  - `results` object, required
    - `data` DiscoveredVendor[], required
      - `id` string, required — The discovered vendor's unique ID.
      - `name` string, required — The discovered vendor's display name .
      - `normalizedName` string, required — The discovered vendor's vendorNormalized or canonical name. This is used to group duplicate vendors together.
      - `category` object, nullable, required — The discovered vendor's category.
        - `name` string, required
      - `source` 'OKTA' | 'JAMF' | 'GSUITE' | 'VENDR' | 'OFFICE', required — The source of the discovered vendor. OKTA: The vendor was discovered via an Okta integration JAMF: The vendor was discovered via a JAMF integration GSUITE: The vendor was discovered via an GSuite integration VENDR: The vendor was discovered via a Vendr integration OFFICE: The vendor was discovered via a microsoft office integration
      - `discoveredDate` string, date-time, required — The discovered vendor's imported date.
      - `numberOfAccounts` number, double, required — The number of accounts in the discovered vendor.
      - `ignored` object, nullable, required — Determines whether or not the vendor is ignored.
        - `ignoredAtDate` string, date-time, nullable, required — The date the discovered vendor was marked as ignored.
        - `ignoredReason` string, nullable, required — The reason the discovered vendor was ignored.
        - `ignoredByUserId` string, nullable, required — The user ID who ignored the discovered vendor.
      - `rejected` object, nullable, required — Determines whether or not the vendor is rejected.
        - `rejectedByUserId` string, nullable, required — The user ID who rejected the discovered vendor.
        - `rejectedReason` string, nullable, required — The reason the discovered vendor was rejected.
        - `rejectedAtDate` string, date-time, nullable, required — The date the discovered vendor was marked as rejected.
    - `pageInfo` PageInfo, required — Provides information about the pagination of a dataset.
      - `endCursor` string, nullable, required — The cursor that points to the end of the current page, or null if there is no such cursor.
      - `hasNextPage` boolean, required — Indicates if there is another page after the current page.
      - `hasPreviousPage` boolean, required — Indicates if there is a page before the current page.
      - `startCursor` string, nullable, required — The cursor that points to the start of the current page, or null if there is no such cursor.

---

[API](https://skmtc.net/vanta/apis/build-integrations.md) · [All operations](https://skmtc.net/vanta/apis/build-integrations/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vanta/build-integrations/revisions/6c1f7590538b/schema)