---
updatedAt: 2026-08-24T17:46:04.000Z
agentTools:
  projectIndex: https://docs.performyard.com/llms.txt
---

# Retrieve a Compensation Cycle's decision information

Retrieves the decision information for a specific compensation cycle. Please note, this endpoint requires the Compensation feature to be enabled for your company. Requests from a company without Compensation enabled are rejected with a 403.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "PerformYard API",
    "description": "The PerformYard API allows customers to programmatically retrieve and manage data related to their performance management processes.",
    "version": "0.1.0",
    "contact": {
      "name": "PerformYard",
      "url": "https://www.performyard.com/contact",
      "email": "info@performyard.com"
    }
  },
  "paths": {
    "/v1/compensation-cycles/{cycleId}/compensation-decisions": {
      "get": {
        "summary": "Retrieve a Compensation Cycle's decision information",
        "tags": [
          "Compensation"
        ],
        "description": "Retrieves the decision information for a specific compensation cycle. Please note, this endpoint requires the Compensation feature to be enabled for your company. Requests from a company without Compensation enabled are rejected with a 403.",
        "parameters": [
          {
            "schema": {
              "type": "string",
              "pattern": "^[0-9]+$"
            },
            "in": "query",
            "name": "limit",
            "required": false,
            "description": "The number of records to be returned in a single API Request."
          },
          {
            "schema": {
              "type": "string",
              "pattern": "^[0-9]+$"
            },
            "in": "query",
            "name": "offset",
            "required": false,
            "description": "Used to paginate through a list of records. Can be combined with limit. Increment the value by one to fetch subsequent pages (1 for the second page, 2 for the third, etc.)."
          },
          {
            "schema": {
              "type": "string"
            },
            "in": "query",
            "name": "sort",
            "required": false,
            "description": "Order in which to return the records. Allowed Values: asc(FIELD_NAME), desc(FIELD_NAME)."
          },
          {
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                }
              ]
            },
            "in": "path",
            "name": "cycleId",
            "required": true,
            "description": "The id of the compensation cycle whose decisions to retrieve."
          }
        ],
        "responses": {
          "200": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "compensation_decisions": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "employee_name": {
                            "type": "string"
                          },
                          "employee_email": {
                            "type": "string"
                          },
                          "job_title": {
                            "type": "string"
                          },
                          "manager": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "nullable": true,
                                "type": "string"
                              },
                              "email": {
                                "nullable": true,
                                "type": "string"
                              }
                            },
                            "required": [
                              "name",
                              "email"
                            ],
                            "additionalProperties": false
                          },
                          "acting_manager": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "nullable": true,
                                "type": "string"
                              },
                              "email": {
                                "nullable": true,
                                "type": "string"
                              }
                            },
                            "required": [
                              "name",
                              "email"
                            ],
                            "additionalProperties": false
                          },
                          "current_salary": {
                            "type": "number"
                          },
                          "currency": {
                            "type": "string"
                          },
                          "increase_percent": {
                            "nullable": true,
                            "type": "number"
                          },
                          "increase_amount": {
                            "nullable": true,
                            "type": "number"
                          },
                          "new_salary": {
                            "nullable": true,
                            "type": "number"
                          },
                          "notes": {
                            "nullable": true,
                            "type": "string"
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "Not Submitted",
                              "Submitted",
                              "Approved"
                            ]
                          }
                        },
                        "required": [
                          "employee_name",
                          "employee_email",
                          "job_title",
                          "manager",
                          "acting_manager",
                          "current_salary",
                          "currency",
                          "increase_percent",
                          "increase_amount",
                          "new_salary",
                          "notes",
                          "status"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "compensation_decisions"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string"
                    },
                    "details": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "string"
                      }
                    }
                  },
                  "required": [
                    "message"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "401": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string"
                    },
                    "details": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "string"
                      }
                    }
                  },
                  "required": [
                    "message"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "403": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string"
                    },
                    "details": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "string"
                      }
                    }
                  },
                  "required": [
                    "message"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "422": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string"
                    },
                    "details": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "string"
                      }
                    }
                  },
                  "required": [
                    "message"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "500": {
            "description": "Default Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string"
                    },
                    "details": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "meta": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "string"
                      }
                    }
                  },
                  "required": [
                    "message"
                  ],
                  "additionalProperties": false
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.talent.performyard.com/"
    }
  ],
  "externalDocs": {
    "url": "https://support.performyard.com/article/183-api-reference",
    "description": "PerformYard API Reference"
  }
}
```