---
title: "List equipment"
method: GET
path: "/api/v1/equipment"
tags: ["Equipment"]
---

# List equipment

`GET /api/v1/equipment`

## Request

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

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

## Query parameters

- `limit` integer
- `cursor` string
- `updated_since` string, date-time

## Response `200`

A paginated list of equipment records.

- EquipmentListResponse
  - `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` ListMeta, required
    - `request_id` string, required
    - `limit` integer, required
    - `has_more` boolean, required
    - `next_cursor` string, nullable, required
  - `links` ListLinks, required
    - `self` string, required
    - `next` string

## 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.
- `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)