---
title: "Get Supplier Provider Details"
method: GET
path: "/supplier_provider/{supplier_provider_uid}"
---

# Get Supplier Provider Details

`GET /supplier_provider/{supplier_provider_uid}`

## Request

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

Returns a single supplier provider with its connection state, the user who connected it, and how many Zuper vendors (supplier branches) are linked to it. When `connection_status` is `RECONNECT_REQUIRED`, `connection_error_message` says why; reconnect it with Update Supplier Provider. Credentials and supplier account details are never returned. Requires supplier integration to be enabled for the company; otherwise the request fails with 400.

## Path parameters

- `supplier_provider_uid` string, required

## 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 or an admin deactivated the provider; reconnect before ordering.
    - `connection_error_message` string, nullable: Why the provider was last disconnected, such as the supplier's authentication error or a manual deactivation. Absent, empty or `null` when there is nothing to report.
    - `is_preferred_supplier` boolean: At most one provider per company is preferred.
    - `is_deleted` boolean: Always `false`; deleted providers are not returned.
    - `is_active` boolean: `false` when an admin has deactivated the provider.
    - `created_by` object, nullable: Zuper user who connected the provider; `null` if that user no longer exists.
      - `user_uid` string
      - `first_name` string
      - `last_name` string
      - `email` string
      - `external_login_id` string, nullable
      - `home_phone_number` string, nullable
      - `designation` string
      - `emp_code` string
      - `prefix` string, nullable
      - `work_phone_number` string, nullable
      - `mobile_phone_number` string, nullable
      - `profile_picture` string, nullable
      - `hourly_labor_charge` number, nullable
      - `is_active` boolean
      - `is_deleted` boolean
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `last_login_at` string, date-time, nullable
      - `is_billable` boolean
      - `license_type` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `associated_vendor_count` integer: Number of Zuper vendors (supplier branches) linked to this provider.
    - `last_synced_at` string, date-time: When Zuper last refreshed the saved catalog prices for this provider from the supplier (scheduled sync). Absent until the first sync.

## Other responses

- `400`: 400
- `404`: 404

## Changes

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

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/supplier_provider/:supplier_provider_uid/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)