---
title: "Get Shift Swaps By Person Id"
method: GET
path: "/api/v1/shift_swaps/person/{person_id}"
tags: ["Swaps"]
---

# Get Shift Swaps By Person Id

`GET /api/v1/shift_swaps/person/{person_id}`

## Path parameters

- `person_id` integer, required — The ID of the person to retrieve

## Query parameters

- `offer_types` string[], nullable — Filter by offer types
- `statuses` string[], nullable — Filter by statuses
- `eager` boolean, nullable — Whether to eager load joins

## Response `200`

Successful Response

- ShiftSwap[]
  - `archived` boolean, nullable — Whether the shift swap has been archived
  - `cancel_requested` boolean, nullable — Whether the shift swap has been requested to be cancelled
  - `end` string, date-time, nullable — The new proposed end time (UTC) of the shift e.g 2023-07-27 06:30:00+00
  - `find_replacement` boolean, nullable — Whether a replacement is needed to be found.
  - `group_id` string, nullable — The ID of the group the shift swap belongs to
  - `id` integer, required — The unique ID of the shift swap
  - `notes` string, nullable — Notes
  - `offer_id` integer, required — The ID of the person who offered the shift
  - `offer_type` string, required — The type of change being requested
  - `publish_calendar` boolean, nullable — How person who made swap request should get notified when status changes
  - `publish_email` boolean, nullable — How person who made swap request should get notified when status changes
  - `publish_slack` boolean, nullable — How person who made swap request should get notified when status changes
  - `publish_sms` boolean, nullable — How person who made swap request should get notified when status changes
  - `reason` string, nullable — The reason for approving or denying a shift request
  - `shift_id` integer, nullable — The ID of the shift being swapped
  - `start` string, date-time, nullable — The new proposed start time (UTC) of the shift e.g 2023-07-27 06:30:00+00
  - `status` string, nullable — The status of the shift swap
  - `time_created` string, date-time, required — The time when the shift swap was created
  - `time_updated` string, date-time, required — The time when the shift swap was last updated
  - `value` number, nullable — The value of the shift swap

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/joinplanbase/apis/planbase-api.md) · [All operations](https://skmtc.dev/joinplanbase/apis/planbase-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/joinplanbase/planbase-api/revisions/501c09a03cbc/schema)