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

# List vendors

`GET /v1/vendors`

## Request

- Base URL: `https://api.navigateai.co`
- URL: `https://api.navigateai.co/v1/vendors`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/navigateai/apis/navigateai-api/docs/v1/vendors/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `limit` integer
- `cursor` string, nullable
- `reference_key` string, nullable
- `is_enabled` boolean, nullable: Filter to only vendors which are or are not enabled. Omit to list all vendors.

## Response `200`

OK

- ListVendorOrganizationsResponse
  - `vendors` VendorOrganizationExternalSchema[], required
    - `id` string, required
    - `name` string, required
    - `email` string, nullable, required
    - `reference_key` string, required: Optional unique identifier for this vendor in your system.
    - `is_enabled` boolean, required: Whether this vendor is enabled.
    - `market_ids` string[], required: IDs of the markets this vendor serves. A vendor with no market associations serves all markets.
  - `next_cursor` string, nullable, required

---

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