---
title: "List resources"
method: GET
path: "/v1/resources"
tags: ["Resources"]
---

# List resources

`GET /v1/resources`

## Request

- Base URL: `https://api.workwing.io`
- URL: `https://api.workwing.io/v1/resources`
- Auth: HTTP bearer

List resources (your engineers and other field staff).

- `?is_available=is.true` - Filter available resources
- `?tags=cs.{plumbing}` - Filter by tag (contains)
- `?select=id,user_id,is_available,tags` - Field selection
- `?select=*,user:users(full_name,email)` - Include user details

## Query parameters

- `select` string
- `order` string
- `limit` integer
- `offset` integer

## Response `200`

Array of resources

- object: Array of resources
  - `data` object[]
    - `id` string, uuid
    - `user_id` string, uuid: The user this resource represents (required on create)
    - `display_name` string, nullable: Display name (auto-populated from the linked user)
    - `email` string, email, nullable
    - `is_available` boolean, nullable: Whether the resource is available for assignments
    - `availability_status` 'T_AVAILABLE' | 'T_ON_BREAK' | 'T_UNAVAILABLE'
    - `break_started_at` string, date-time, nullable
    - `break_reason` string, nullable
    - `current_latitude` number, nullable: The resource's live position, for your own team only: do not show it to customers. For a customer-facing tracking page use GET /v1/jobs/{jobId}/tracking.
    - `current_longitude` number, nullable
    - `location_accuracy` number, nullable: Reported accuracy of the live position, in metres
    - `location_updated_at` string, date-time, nullable
    - `tags` string[], nullable: Resource tags/skills
    - `created_by_user_id` string, uuid, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
  - `meta` object
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `401`: Default Response
- `429`: Default Response

---

[API](https://skmtc.dev/workwing/apis/workwing-api.md) · [All operations](https://skmtc.dev/workwing/apis/workwing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/workwing/apis/workwing-api/revisions/54bb14368a35?raw)