---
title: "Get a supplier"
method: GET
path: "/api/v1/sa/inventory/suppliers/{supplierId}"
tags: ["Suppliers"]
---

# Get a supplier

`GET /api/v1/sa/inventory/suppliers/{supplierId}`

## Request

- Base URL: `https://app.sellerassistant.app` (the document declares no server; this is the origin it was published from)
- URL: `https://app.sellerassistant.app/api/v1/sa/inventory/suppliers/{supplierId}`
- Auth: one of:
  - API key in query parameter `api_key`
  - API key in header `X-Api-Key`

Gives one supplier of the team.

## Path parameters

- `supplierId` integer, required

## Response `200`

Successful response

- object
  - `data` Supplier: Supplier entity
    - `id` integer: Unique supplier identifier
    - `team_id` integer: Team ID that owns this supplier
    - `user_id` integer: Responsible user ID
    - `name` string, nullable: Supplier name
    - `website` string, nullable: Supplier website
    - `status` string, nullable: Supplier status: New, Contacted, Approved, Rejected, Negotiation, No response, Active, On hold
    - `type` string, nullable: Supplier type: Distributor, Manufacturer, Brand, Wholesaler
    - `payment_method` string[]: Payment methods: Credit card, ACH, Wire transfer
    - `payment_terms` string, nullable: Payment terms: Net 15, Net 30, Net 45, Net 60, COD, Prepaid
    - `currency` string, nullable: Currency code (USD, EUR, GBP, etc.)
    - `contacts` string, nullable: Contact information
    - `contact_name` string, nullable: Contact person name
    - `phone` string, nullable: Phone number
    - `address` string, nullable: Address
    - `default_prep_center_id` integer, nullable: Default warehouse/prep center ID
    - `note` string, nullable: Additional notes
    - `mov` number, nullable: Minimum order value
    - `free_shipping_ov` number, nullable: Order value that makes the shipping free
    - `sold_by_case` boolean: The supplier sells by the case
    - `lead_time_min` integer, nullable: Minimum lead time in days
    - `lead_time_max` integer, nullable: Maximum lead time in days
    - `created_at` string, date-time: Creation timestamp
    - `updated_at` string, date-time: Last update timestamp

## Other responses

- `400`: Bad request - validation failed or invalid parameters
- `402`: Payment Required - subscription expired or payment method required
- `403`: Access denied - insufficient permissions, invalid API key, or the API request limit is used up (`public_api_key_limit`)
- `404`: Resource not found
- `422`: Business logic error - operation cannot be completed due to business rules
- `429`: Too many requests - rate limit exceeded

---

[API](https://skmtc.dev/sellerassistant/apis/seller-assistant-public-api.md) · [All operations](https://skmtc.dev/sellerassistant/apis/seller-assistant-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sellerassistant/apis/seller-assistant-public-api/revisions/5b3ecdbcadb6?raw)