# GET /v1/suppliers/{supplierId}

**Service:** Suppliers  
**Operation:** `SupplierService_GetSupplier`

Returns the supplier matching the given id. Useful when you already have a supplier id (for example from an inventory filter) and need its details without listing.

## Parameters

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `supplierId` | path | string | yes | The id of the supplier to retrieve. Required. |

## Responses

| Status | Schema | Description |
| --- | --- | --- |
| 200 | `GetSupplierResponse` | A successful response. |
| 400 | `Error` | The request was rejected because it was malformed — for example a badly formed id. The body is a validation-failure envelope: an overall type and message and one entry per problem (each with a stable code, a message, and a param pointing at the offending parameter). |
| 401 | `Error` | The request is missing a valid bearer token, or the token is invalid or expired. |
| 403 | `Error` | The token is valid but does not permit this action, or the resource belongs to a company the token cannot act for. The error type is permission_denied. |
| 404 | `Error` | No supplier with the given id exists for the authenticated company. |
| 429 | `Error` | The request was throttled (rate_limited) or exceeded a size limit (resource_exhausted). When throttled, the Retry-After header says how many seconds to wait before retrying; a resource_exhausted request will fail the same way if retried unchanged. |
| default | `Error` | Any other error. The body is the same error envelope every error uses: a short stable type identifying the kind of failure (for example "rate_limited" or "internal"), a human-readable message, and the request's idempotency key echoed back when one was supplied. |

## Returns

`GetSupplierResponse`

| Field | Type | Description |
| --- | --- | --- |
| `supplier` | Supplier | The requested supplier. |
| `supplier.supplierId` | string | The supplier's unique id. |
| `supplier.name` | string | The supplier's name. |

---

Source: https://developer.factory.app/reference/suppliers/get-supplier · Factory Sales API v1