---
title: "Get equipment"
method: GET
path: "/api/v1/equipment/{equipmentId}"
tags: ["Equipment"]
---

# Get equipment

`GET /api/v1/equipment/{equipmentId}`

## Request

- Base URL: `https://app.drillerdb.com`
- URL: `https://app.drillerdb.com/api/v1/equipment/{equipmentId}`
- Auth: API key in header `X-API-Key`

Get equipment Requires an Enterprise-plan API key (X-API-Key header) carrying the equipment:read scope.

## Path parameters

- `equipmentId` string, required

## Response `200`

Equipment detail.

- EquipmentResponse
  - `data` Equipment, required
    - `id` string, required
    - `name` string, required
    - `make` string, nullable
    - `model` string, nullable
    - `year` integer, nullable
    - `status` string, nullable
    - `category` string, nullable
    - `assigned_employee_id` union
      - integer
      - string
    - `last_location` Coordinates, required
      - `latitude` number, nullable
      - `longitude` number, nullable
      - `updated_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `created_at` string, date-time, nullable
  - `meta` RequestMeta, required
    - `request_id` string, required
  - `links` ItemLinks, required
    - `self` string, required

## Other responses

- `401`: Missing, invalid, inactive, or expired API key.
- `403`: The API key lacks scope or the company is not entitled to API access.
- `404`: The requested equipment record does not exist in the API key company scope.
- `405`: The path exists but not for this HTTP method. Every route is GET (HEAD and OPTIONS are also accepted).
- `429`: The key exceeded its configured rate limits.
- `503`: The public API schema has not been migrated in this environment yet.

---

[API](https://skmtc.dev/drillerdb/apis/drillerdb-public-apis.md) · [All operations](https://skmtc.dev/drillerdb/apis/drillerdb-public-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/drillerdb/apis/drillerdb-public-apis/revisions/aeb372774d99?raw)