---
title: "Retrieve Vendor"
method: GET
path: "/vendors/{id}"
tags: ["Vendors"]
---

# Retrieve Vendor

`GET /vendors/{id}`

## Request

- Base URL: `https://secure.fleetio.com/api`
- URL: `https://secure.fleetio.com/api/vendors/{id}`
- Auth: API key in header `Authorization` and API key in header `Account-Token`
- TypeScript: <https://skmtc.dev/fleetio/apis/fleetio-developer-api/docs/vendors/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the details of an existing Vendor.

## Path parameters

- `id` string, required

## Response `200`

OK

- Vendor, nullable: A Vendor
  - `id` integer, required
  - `created_at` string, date-time: The date and time at which this record was created.
  - `updated_at` string, date-time: The date and time at which this record was most recently updated.
  - `name` string, required: The name of the Vendor.
  - `phone` string, nullable, required: The phone number of the Vendor.
  - `street_address` string, nullable, required: The street address of the Vendor.
  - `street_address_line_2` string, nullable, required: The second line of the street address of the Vendor.
  - `city` string, nullable, required: The city of the Vendor.
  - `region` string, nullable, required: The region, state, province, or territory of the Vendor.
  - `postal_code` string, nullable, required: The postal code or ZIP code of the Vendor.
  - `country` string, nullable, required: The country of the Vendor.
  - `website` string, nullable, required: The website of the Vendor.
  - `notes` string, nullable, required: Additional notes about the Vendor.
  - `fuel` boolean, nullable, required: Indicates whether the Vendor provides fuel.
  - `service` boolean, nullable, required: Indicates whether the Vendor provides service.
  - `parts` boolean, nullable, required: Indicates whether the Vendor provides parts.
  - `vehicle` boolean, nullable, required: Indicates whether the Vendor provides vehicles.
  - `contact_name` string, nullable, required: The name of the contact person for the Vendor.
  - `contact_email` string, nullable, required: The email address of the contact person for the Vendor.
  - `contact_phone` string, nullable, required: The phone number of the contact person for the Vendor.
  - `latitude` number, float, nullable, required: The latitude of the Vendor's location.
  - `longitude` number, float, nullable, required: The longitude of the Vendor's location.
  - `external_id` string, nullable, required: The external identifier of the Vendor.
  - `archived_at` string, nullable, required: The date and time when the Vendor was archived, if applicable.
  - `labels` object[], required
    - `id` integer
    - `name` string
  - `custom_fields` CustomFields, nullable, required: *Full details on working with Custom Fields [here](/docs/overview/custom-fields).

## Other responses

- `401`: Request could not be authenticated
- `403`: Insufficient permission to perform this operation
- `404`: The requested resource could not be located
- `500`: Something unexpected happened

---

[API](https://skmtc.dev/fleetio/apis/fleetio-developer-api.md) - [All operations](https://skmtc.dev/fleetio/apis/fleetio-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fleetio/apis/fleetio-developer-api/revisions/49558d744bd7?raw)