---
title: "POST /api/v1/repairers.approved-suppliers.list"
method: POST
path: "/api/v1/repairers.approved-suppliers.list"
tags: ["business-rules"]
---

# POST /api/v1/repairers.approved-suppliers.list

`POST /api/v1/repairers.approved-suppliers.list`

## Request

- Base URL: `https://api.partly.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.partly.com/api/v1/repairers.approved-suppliers.list`
- Auth: none declared. Required headers: `authorization`

Returns, for each requested repairer site, the suppliers it has approved, with its approval terms, what each supplies for the vehicle, and how it takes orders. Each site pages separately, ordered by supplier organization and business.

## Headers

- `authorization` string, required: UTF-8 encoded string

## Request body

- RepairersApprovedSuppliersListRequest
  - `sites` unknown[], required: A value whose length (characters for strings, items for arrays) must be within MIN..=MAX (inclusive). Violating requests are rejected with HTTP 400.
    - unknown
  - `subject_organization_id` string, uuid: UUID value type
  - `vehicle` union
    - object
      - `type` 'unknown', required
    - object
      - `make` string, required: UTF-8 encoded string
      - `type` 'make', required
    - object
      - `build_year` integer: 16-bit unsigned integer
      - `make` string, required: UTF-8 encoded string
      - `model` string, required: UTF-8 encoded string
      - `type` 'model', required

## Response `200`

200 OK

- RepairersApprovedSuppliersListResponse
  - `sites` RepairersApprovedSuppliersListSiteSuppliers[], required: Expandable array type
    - `next_cursor` string: UTF-8 encoded string
    - `repairer_site_id` string, uuid, required: UUID value type
    - `suppliers` RepairersApprovedSuppliersListSupplier[], required: Expandable array type
      - `business_id` string, uuid, required: UUID value type
      - `ordering` union, required
        - 'provisional'
        - 'standard'
      - `organization_id` string, uuid, required: UUID value type
      - `supply` union, required
        - object
          - `type` 'excluded', required
        - object
          - `type` 'included', required
          - `types` BusinessNetworkSupplyType[], required: Value set type
            - union
              - …
        - object
          - `type` 'unconfigured', required
      - `terms` RepairersApprovedSuppliersListApprovalTerms, required
        - `order_creation` union, required
          - 'allowed'
          - 'disallowed'
        - `order_editing` union, required
          - 'allowed'
          - 'disallowed'

## Other responses

- `default`: Error cases

## Changes

- **2026-10-21** `2c41be13ab68`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/partly/apis/core-server/changes/api/v1/repairers.approved-suppliers.list/post.md)

---

[API](https://skmtc.dev/partly/apis/core-server.md) - [All operations](https://skmtc.dev/partly/apis/core-server/llms.txt) - [OpenAPI document](https://skmtc.dev/partly/apis/core-server/revisions/45c08c52a8e6?raw)