DEdeputy
Swaps

Get pending approval shift swaps

Retrieves shift swaps that are pending approval. Returns swap requests sorted by source shift start time and ID in ascending order. Supports filtering by location mode and pagination. Can return count-only results for performance. Includes metadata with location, area, and employee profile information.

post/management/v2/shifts/swap/pending-approvals

Request

  • Base URL
    https://your-subdomain.deputy.deputy.com/api
  • URL
    https://your-subdomain.deputy.deputy.com/api/management/v2/shifts/swap/pending-approvals
  • Auth
    API key in header OAuth

Query parameters

countOnlyboolean

Request body

locationMode'ALL' | 'SELECTED'

LocationMode specifies how location filtering should be applied.

  • ALL: Include all locations accessible by the current user (no filtering)
  • SELECTED: Filter to only selected locations (requires locationIds to be provided)
locationIdsinteger[]
cursorstring
limitinteger

Response

A successful response.

successboolean

Changes

No recorded changes to this operation across all 1 revision of this API.