---
title: "List User Wages"
method: GET
path: "/v2/company/{company_id}/users/{user_id}/wages"
tags: ["User Wages"]
---

# List User Wages

`GET /v2/company/{company_id}/users/{user_id}/wages`

## Request

- Base URL: `https://api.7shifts.com`
- URL: `https://api.7shifts.com/v2/company/{company_id}/users/{user_id}/wages`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.7shifts.com/oauth2/authorize`
    - Client credentials
    - Password
    - Token URL: `https://app.7shifts.com/oauth2/token`
  - API key in cookie `7session`

## Path parameters

- `company_id` integer, required
- `user_id` integer, required

## Headers

- `x-api-version` string: An API version
- `x-company-guid` string, uuid

## Response `200`

OK

- object
  - `object` 'user_wages', required
  - `data` object, required
    - `wage_type` 'hourly' | 'weekly_salary' | 'annual_salary', nullable, required
    - `current_wages` object[], required
      - `id` integer, required: Wage ID
      - `effective_date` string, required: The wage effective date. Format YYYY-MM-DD
      - `role_id` integer, nullable, required: Role ID
      - `wage_type` 'hourly' | 'weekly_salary' | 'annual_salary', required: The wage type
      - `wage_cents` integer, required: The wage value. In cents
      - `enabled_days` object, nullable: Days of the week when the wage is applicable. All days keyed by full name (Sunday-Saturday).
        - `Sunday` boolean, required
        - `Monday` boolean, required
        - `Tuesday` boolean, required
        - `Wednesday` boolean, required
        - `Thursday` boolean, required
        - `Friday` boolean, required
        - `Saturday` boolean, required
      - `allocations` object[], nullable: Salary allocation breakdown by location. Only applicable for salary wage types. All amount_tenths values must sum to 1000.
        - `location_id` integer, required: Location ID
        - `amount_tenths` integer, required: Allocation amount in tenths of a percent (1–1000). All entries must sum to 1000.
      - `created` string, date-time, required: The created date and time of the wage. Formatted as ISO8601 datetime in UTC timezone.
      - `modified` string, date-time, required: The modified date and time of the wage. Formatted as ISO8601 datetime in UTC timezone.
    - `upcoming_wages` object[], required
      - `id` integer, required: Wage ID
      - `effective_date` string, required: The wage effective date. Format YYYY-MM-DD
      - `role_id` integer, nullable, required: Role ID
      - `wage_type` 'hourly' | 'weekly_salary' | 'annual_salary', required: The wage type
      - `wage_cents` integer, required: The wage value. In cents
      - `enabled_days` object, nullable: Days of the week when the wage is applicable. All days keyed by full name (Sunday-Saturday).
        - `Sunday` boolean, required
        - `Monday` boolean, required
        - `Tuesday` boolean, required
        - `Wednesday` boolean, required
        - `Thursday` boolean, required
        - `Friday` boolean, required
        - `Saturday` boolean, required
      - `allocations` object[], nullable: Salary allocation breakdown by location. Only applicable for salary wage types. All amount_tenths values must sum to 1000.
        - `location_id` integer, required: Location ID
        - `amount_tenths` integer, required: Allocation amount in tenths of a percent (1–1000). All entries must sum to 1000.
      - `created` string, date-time, required: The created date and time of the wage. Formatted as ISO8601 datetime in UTC timezone.
      - `modified` string, date-time, required: The modified date and time of the wage. Formatted as ISO8601 datetime in UTC timezone.

## Other responses

- `403`: Forbidden
- `404`: Not found
- `500`: Server Error

---

[API](https://skmtc.dev/7shifts/apis/7shifts-api.md) - [All operations](https://skmtc.dev/7shifts/apis/7shifts-api/llms.txt) - [OpenAPI document](https://skmtc.dev/7shifts/apis/7shifts-api/revisions/40e0ef40dfcd?raw)