---
title: "Get Subcontractors"
method: GET
path: "/subcontractors"
---

# Get Subcontractors

`GET /subcontractors`

## Request

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

Operates on Subcontractors, shown in the Zuper client app as "Subcontractor" (in every industry). Subcontractors share the exact same underlying schema and endpoints as Vendors / Suppliers; they're distinguished only by the `vendor_type` field (`SUB_CONTRACTOR` here) and the `/subcontractors` route prefix. `vendor_type` is always enforced server-side based on this route; you cannot use this endpoint to read the other module's records.

## Query parameters

- `page` integer
- `count` string
- `sort` 'ASC' | 'DESC'
- `sort_by` string
- `filter.is_active` boolean
- `filter.keyword` string
- `filter.created_by` string
- `filter.is_deleted` boolean
- `filter.from_catalog_count` integer
- `filter.to_catalog_count` integer
- `filter.from_lead_time` integer
- `filter.to_lead_time` integer
- `filter.last_ordered_from_date` string, date
- `filter.last_ordered_to_date` string, date
- `filter.created_from_date` string, date
- `filter.created_to_date` string, date
- `filter.updated_from_date` string, date
- `filter.updated_to_date` string, date
- `filter.vendor_delivery_method` string
- `filter.custom_field` string
- `filter.supplier_provider_uid` string
- `filter.integrated_vendors` boolean
- `filter.favorite_supplier_vendor` boolean

## Response `200`

200

- object
  - `type` 'SUCCESS'
  - `message` string
  - `data` object[]: Deselects _id, company_id, __v, accounts, vendor_bank_details, vendor_contacts, attachments, and internal supplier-integration IDs.
  - `total_records` integer
  - `current_page` integer
  - `total_pages` integer

## Changes

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

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