---
title: "Get Supplier"
method: GET
path: "/api/v1/admin/suppliers/{supplier_id}"
tags: ["admin-suppliers"]
---

# Get Supplier

`GET /api/v1/admin/suppliers/{supplier_id}`

Get full supplier detail.

Returns inactive rows too — the admin needs to see + restore them.

## Path parameters

- `supplier_id` string, uuid, required

## Response `200`

Successful Response

- SupplierContactRead — Full detail response — used by GET/POST/PATCH/restore. Note: ``declined_project_ids`` is NOT exposed here even though the model has it — v1 UI does not display it. Re-add when an "incident history" feature wants it.
  - `name` string, required
  - `email` string, email, required
  - `company` string, nullable
  - `location` string, nullable
  - `capabilities` SupplierCapabilities — Typed shape for ``supplier_contacts.capabilities`` JSONB. V1 (iteration 2): only ``processes`` is edited via UI. The list is ORDERED — index 0 is the supplier's most preferred capability ("we use this supplier mainly for CNC milling"). Ranking feeds the future :func:`select_suppliers_for_project` weighting. Other dimensions on legacy rows (materials/finishes/coatings/ certifications/max_envelope_mm) are silently ignored on read (Pydantic v2 default ``extra='ignore'``) and overwritten on first UI-driven update. This is intentional — admins asked us to drop them from the v1 directory.
    - `processes` string[] — Ranked list of canonical ``dropdowns.value`` strings for category=``machining_process``. Index 0 is most preferred.
  - `trust_tier` 'new' | 'trusted' | 'restricted'
  - `notes` string, nullable
  - `admin_routing_notes` string, nullable
  - `id` string, uuid, required
  - `active` boolean, required
  - `last_contacted_at` string, date-time, nullable, required
  - `response_count` integer, required
  - `decline_count` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/prototyping/apis/prototyping-io-api.md) · [All operations](https://skmtc.dev/prototyping/apis/prototyping-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prototyping/prototyping-io-api/revisions/f4a0079fbb57/schema)