---
title: "Get Supplier Providers"
method: GET
path: "/supplier_provider"
---

# Get Supplier Providers

`GET /supplier_provider`

## Request

- Base URL: `https://dc-region.zuperpro.com/api`
- URL: `https://dc-region.zuperpro.com/api/supplier_provider`
- Auth: API key in header `x-api-key`

Lists the supplier providers (SRS, ABC Supply, QXO) connected to your company, newest first by default. Each entry shows the connection state and how many Zuper vendors are linked to the provider, so you can spot providers that need reconnecting before placing orders. Credentials are never returned. Requires supplier integration to be enabled for the company; otherwise the request fails with 400.

## Query parameters

- `page` integer
- `limit` integer
- `sort_by` 'supplier_provider_name' | 'supplier_provider_type' | 'created_at' | 'updated_at'
- `sort_order` 'ASC' | 'DESC'
- `is_active` boolean
- `supplier_provider_type` 'SRS' | 'ABC_SUPPLY' | 'QXO'

## Response `200`

200

- object
  - `type` 'success'
  - `title` string
  - `message` string
  - `data` object[]
    - `supplier_provider_uid` string
    - `supplier_provider_name` string
    - `supplier_provider_type` 'SRS' | 'ABC_SUPPLY' | 'QXO'
    - `connection_status` 'CONNECTED' | 'NOT_CONNECTED' | 'RECONNECT_REQUIRED': `RECONNECT_REQUIRED` means the supplier rejected the stored credentials; reconnect before ordering.
    - `is_active` boolean
    - `is_preferred_supplier` boolean: At most one provider per company is preferred.
    - `associated_vendor_count` integer: Number of Zuper vendors (supplier branches) linked to this provider.
  - `current_page` integer
  - `current_records` integer
  - `total_records` integer
  - `total_pages` integer

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `3c21bc232e16`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/supplier_provider/get.md)

---

[API](https://skmtc.dev/zuper/apis/zuper-pro-api.md) - [All operations](https://skmtc.dev/zuper/apis/zuper-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zuper/apis/zuper-pro-api/revisions/3c21bc232e16?raw)