---
title: "Returns one vendor."
method: GET
path: "/api/v1/vendors/{id}"
tags: ["Vendors"]
---

# Returns one vendor.

`GET /api/v1/vendors/{id}`

## Request

- Base URL: `https://app.flexonthejob.com`
- URL: `https://app.flexonthejob.com/api/v1/vendors/{id}`
- Auth: HTTP bearer

Requires `ViewPurchaseOrders`. `id` may be the numeric id or the `syncId`. Sends a weak `ETag`.

## Path parameters

- `id` string, required

## Response `200`

The vendor.

- VendorDto: A vendor (supplier) the organization buys from, as returned by `/api/v1/vendors`. Use the id as `vendorId` when creating a purchase order.
  - `id` integer: Numeric id, usable in `/api/v1/vendors/{id}` and as a purchase order's `vendorId`. Example: `7`.
  - `syncId` string, uuid: Stable cross-device id; also the pagination cursor.
  - `name` string: Vendor name, unique in the organization. Example: `Acme Supply`.
  - `description` string, nullable: Free-text notes about the vendor; null when not recorded.
  - `contactName` string, nullable: Main contact's name; null when not recorded. Example: `Dana Ruiz`.
  - `contactEmail` string, nullable: Main contact's email; null when not recorded. Example: `orders@acme.example`.
  - `contactPhone` string, nullable: Main contact's phone, as typed; null when not recorded. Example: `555-0100`.
  - `website` string, nullable: Vendor website; null when not recorded. Example: `https://acme.example`.
  - `defaultShippingCompany` string, nullable: Carrier the vendor usually ships with; null when not recorded. Example: `UPS`.
  - `isActive` boolean: False for a deactivated vendor: kept for history, not offered on new orders and refused as a new order's `vendorId`.
  - `createdAt` string, date-time: UTC creation time (ISO-8601).
  - `updatedAt` string, date-time: UTC last modification time (ISO-8601).

## Other responses

- `304`: Unchanged since the supplied ETag.
- `401`: Unauthorized
- `403`: Forbidden
- `404`: No such vendor in this organization.
- `429`: Too Many Requests

---

[API](https://skmtc.dev/flexonthejob/apis/flex-api.md) · [All operations](https://skmtc.dev/flexonthejob/apis/flex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flexonthejob/apis/flex-api/revisions/19c8f4d27acf?raw)