Workday

Workday Compensation Plans API

Endpoints for managing compensation plans and grades.

Documentation GitHub OpenAPI

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/workday-compensation-plans-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  title: Workday Compensation Compensation Plans API
  description: Compensation API for managing employee compensation plans, scorecards, scorecard results, and one-time payment requests.
  version: v1
  contact:
    name: Workday Support
    email: support@workday.com
    url: https://www.workday.com/en-us/customer-service/support.html
  license:
    name: Proprietary
    url: https://www.workday.com/en-us/legal.html
servers:
- url: https://wd2-impl-services1.workday.com/ccx/api/compensation/v1/{tenant}
  description: Workday REST API Server
  variables:
    tenant:
      default: tenant_name
      description: The Workday tenant identifier
security:
- OAuth2:
  - r_compensation
  - w_compensation
tags:
- name: Compensation Plans
  description: Endpoints for managing compensation plans and grades.
paths:
  /workers/{ID}/compensationPlans:
    get:
      operationId: getCompensationPlans
      summary: Get Compensation Plans
      description: Returns compensation plans assigned to a worker.
      tags:
      - Compensation Plans
      parameters:
      - $ref: '#/components/parameters/ID'
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/offset'
      responses:
        '200':
          description: Successful response containing compensation plans.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/CompensationPlan'
                  total:
                    type: integer
              examples:
                Getcompensationplans200Example:
                  summary: Default getCompensationPlans 200 response
                  x-microcks-default: true
                  value:
                    data:
                    - id: abc123
                      descriptor: example_value
                      compensationPlanType: example_value
                      amount: 42.5
                      effectiveDate: '2026-01-15'
                    total: 10
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /workers/{ID}/requestCompensationChange:
    post:
      operationId: requestCompensationChange
      summary: Request Compensation Change
      description: Initiates a compensation change request for a worker.
      tags:
      - Compensation Plans
      parameters:
      - $ref: '#/components/parameters/ID'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompensationChangeRequest'
            examples:
              RequestcompensationchangeRequestExample:
                summary: Default requestCompensationChange request
                x-microcks-default: true
                value:
                  effectiveDate: '2026-01-15'
                  reason:
                    id: abc123
                    descriptor: example_value
                    href: https://www.example.com
                  proposedCompensation:
                    amount: 42.5
                    currency:
                      id: abc123
                      descriptor: example_value
                      href: https://www.example.com
                    frequency:
                      id: abc123
                      descriptor: example_value
                      href: https://www.example.com
                    compensationGrade:
                      id: abc123
                      descriptor: example_value
                      href: https://www.example.com
                    compensationStep:
                      id: abc123
                      descriptor: example_value
                      href: https://www.example.com
      responses:
        '201':
          description: Compensation change request created successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  descriptor:
                    type: string
              examples:
                Requestcompensationchange201Example:
                  summary: Default requestCompensationChange 201 response
                  x-microcks-default: true
                  value:
                    id: abc123
                    descriptor: example_value
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /compensationGrades:
    get:
      operationId: getCompensationGrades
      summary: Get Compensation Grades
      description: Returns a collection of compensation grades.
      tags:
      - Compensation Plans
      parameters:
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/offset'
      responses:
        '200':
          description: Successful response containing compensation grades.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/CompensationGrade'
                  total:
                    type: integer
              examples:
                Getcompensationgrades200Example:
                  summary: Default getCompensationGrades 200 response
                  x-microcks-default: true
                  value:
                    data:
                    - id: abc123
                      descriptor: example_value
                      name: Example Title
                      isInactive: true
                      minimumAmount: 42.5
                      midpointAmount: 42.5
                      maximumAmount: 42.5
                    total: 10
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  parameters:
    offset:
      name: offset
      in: query
      required: false
      description: The zero-based index of the first object in a response collection.
      schema:
        type: integer
        default: 0
    limit:
      name: limit
      in: query
      required: false
      description: The maximum number of objects in a single response.
      schema:
        type: integer
        default: 20
        maximum: 100
    ID:
      name: ID
      in: path
      required: true
      description: The Workday ID of the resource.
      schema:
        type: string
  schemas:
    CompensationChangeRequest:
      type: object
      properties:
        effectiveDate:
          type: string
          format: date
          description: The effective date of the compensation change.
          example: '2026-01-15'
        reason:
          $ref: '#/components/schemas/ResourceReference'
        proposedCompensation:
          type: object
          properties:
            amount:
              type: number
              format: double
            currency:
              $ref: '#/components/schemas/ResourceReference'
            frequency:
              $ref: '#/components/schemas/ResourceReference'
            compensationGrade:
              $ref: '#/components/schemas/ResourceReference'
            compensationStep:
              $ref: '#/components/schemas/ResourceReference'
          example: example_value
      required:
      - effectiveDate
      - reason
    ResourceReference:
      type: object
      properties:
        id:
          type: string
          example: abc123
        descriptor:
          type: string
          example: example_value
        href:
          type: string
          format: uri
          example: https://www.example.com
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          example: example_value
        errors:
          type: array
          items:
            type: object
            properties:
              error:
                type: string
              field:
                type: string
          example: []
    CompensationPlan:
      type: object
      properties:
        id:
          type: string
          description: The Workday ID of the compensation plan.
          example: abc123
        descriptor:
          type: string
          description: A display descriptor for the plan.
          example: example_value
        compensationPlanType:
          type: string
          description: The type of compensation plan (e.g., Salary, Allowance, Bonus).
          example: example_value
        compensationPlan:
          $ref: '#/components/schemas/ResourceReference'
        amount:
          type: number
          format: double
          description: The compensation amount.
          example: 42.5
        currency:
          $ref: '#/components/schemas/ResourceReference'
        frequency:
          $ref: '#/components/schemas/ResourceReference'
        effectiveDate:
          type: string
          format: date
          example: '2026-01-15'
        compensationGrade:
          $ref: '#/components/schemas/ResourceReference'
        compensationStep:
          $ref: '#/components/schemas/ResourceReference'
    CompensationGrade:
      type: object
      properties:
        id:
          type: string
          example: abc123
        descriptor:
          type: string
          example: example_value
        name:
          type: string
          example: Example Title
        isInactive:
          type: boolean
          example: true
        compensationGradeProfile:
          $ref: '#/components/schemas/ResourceReference'
        minimumAmount:
          type: number
          format: double
          example: 42.5
        midpointAmount:
          type: number
          format: double
          example: 42.5
        maximumAmount:
          type: number
          format: double
          example: 42.5
        currency:
          $ref: '#/components/schemas/ResourceReference'
  responses:
    Unauthorized:
      description: Authentication credentials were missing or invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    BadRequest:
      description: The request was invalid or malformed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: The requested resource was not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://wd2-impl-services1.workday.com/ccx/oauth2/{tenant}/authorize
          tokenUrl: https://wd2-impl-services1.workday.com/ccx/oauth2/{tenant}/token
          scopes:
            r_compensation: Read compensation data
            w_compensation: Write compensation data

Workday Compensation Plans API

Documentation

Specifications

Schemas & Data

Other Resources