| Time | Status | User Agent |  |
| :-- | :-- | :-- | :-- |
| Make a request to see history. |

#### URL Expired

The URL for this request expired after 30 days.

**corporationId**  
string  
required  
The identifier of the corporation or issuer. Identifiers can be retrieved via the [List Corporations](https://docs.carta.com/carta/reference/v1alpha1listcorporations) endpoint.

**postMoneyValuationBucket**  
string  
required  
The peer group used to segment the underlying data. Possible values can be retrieved from the `GetCompensationBenchmarkAttributes` endpoint.

**geoAdjustmentLocation**  
string  
required  
The location used to geo-adjust the benchmarks. Possible values can be retrieved from the `GetCompensationBenchmarkAttributes` endpoint.

**jobArea**  
string  
required  
The job area that the underlying data is segmented by. Possible values can be retrieved from the `GetCompensationBenchmarkAttributes` endpoint.

**compensationType**  
string  
The compensation type of the benchmark. Possible values can be retrieved from the `GetCompensationBenchmarkAttributes` endpoint.

An empty `compensationType` returns benchmark values for all compensation types.

**jobSpecialization**  
string  
The job specialization that the underlying data is segmented by. Possible values can be retrieved from the `GetCompensationBenchmarkAttributes` endpoint.

An empty `jobSpecialization` returns the benchmarks for the roll-up segment.

**jobLevel**  
string  
The job level that the underlying data is segmented by. Possible values can be retrieved from the `GetCompensationBenchmarkAttributes` endpoint.

An empty job_level returns the benchmarks for all job levels.

**pageSize**  
int32  
The maximum number of benchmarks to return. The service may return fewer than this value.

If unspecified, at most 100 benchmarks will be returned.

The maximum value is 100; values above 100 will be coerced to 100.

**pageToken**  
string  
A page token received as `nextPageToken` in a previous Get Compensation Benchmarks response. Provide this to retrieve the subsequent page.

When paginating, all other parameters must be kept consistent with those used in the request where the page token was obtained.

# ``200      A successful response.

**object**

The response for the GetCompensationBenchmarks endpoint.

**access**  
object  
required  
Context about the access of a given corporation.

**accessLevel**  
string  
required  
length between 1 and 100  
The access level of a given corporation.

**accessReason**  
string  
length ≤ 1000  
Details about the access level of a given corporation.

**benchmarksMetadata**  
object  
required  
Context on the benchmark version of the benchmarks being returned. May differ by corporation.

**benchmarksVersionDatetime**  
object  
required  
The datetime that these benchmarks were first released in Carta.

**benchmarksVersionDatetime object**

**benchmarks**  
array of objects  
length ≤ 50  
The compensation benchmarks.

**benchmarks**  
object  
The compensation benchmarks.

**postMoneyValuationBucket**  
string  
required  
length between 1 and 50  
The company valuation bucket that the underlying data is segmented by.

**industry**  
string  
required  
length between 1 and 100  
The industry that the underlying data is segmented by.

**geoAdjustmentLocation**  
string  
required  
length between 1 and 100  
The location used to geo-adjust the benchmarks.

Note that a company may have location-based pay settings in their Carta Total Compensation compensation plan which may override the requested value.

**jobArea**  
string  
required  
length between 1 and 50  
The job area that the underlying data is segmented by.

**jobSpecialization**  
string  
required  
length ≤ 100  
The job specialization that the underlying data is segmented by.

An empty job specialization denotes the benchmark for the roll-up job area.

**jobLevel**  
string  
required  
length between 1 and 10  
The job level that the underlying data is segmented by.

**benchmarkValues**  
array of objects  
length ≤ 50  
The benchmark values for this segment of data.

**benchmarkValues**  
object  
A compensation benchmark value.

**compensationType**  
string  
required  
length between 1 and 50  
The compensation type of the benchmark.

**percentile**  
string  
required  
length between 1 and 10  
The percentile of the benchmark.

For example: "P25" represents the 25th percentile.

**benchmark**  
object  
The ordinal value of the benchmark.

"SALARY" and "TOTAL_CASH" are annual values in US dollars (USD).

"EQUITY_AS_FULLY_DILUTED_PERCENT" is represented as a annual grant value between 0 and 100: 1 represents 1%.

For CEO Founder benchmarks, this value represents total ownership instead of an annual grant value.

**benchmark object**

**nextPageToken**  
string  
Submit the `nextPageToken` string as `pageToken` in a subsequent request to retrieve the next page.

If the Get Compensation Benchmarks response omits `nextPageToken`, then there are no subsequent pages.

# ``400      Returned if required fields are omitted or if provided fields fail validation.

# ``401      Returned if a valid `Authorization` header has not been included with the request.

# ``403      Returned when the user does not have permission to access the resource.

# ``500      Returned if an unexpected internal server error is encountered.

# ``default      An unexpected error response.

---

```

**Example Response**  
```json
{
  "access": {
    "accessLevel": "FULL_ACCESS",
    "accessReason": ""
  },
  "benchmarksMetadata": {
    "benchmarksVersionDatetime": {
      "value": "2024-01-01T09:00:00.000000Z"
    }
  },
  "benchmarks": [
    {
      "postMoneyValuationBucket": "100M to 250M",
      "industry": "All",
      "geoAdjustmentLocation": "New York-Newark-Jersey City, NY-NJ-PA",
      "jobArea": "Engineering",
      "jobSpecialization": "Web Engineer",
      "jobLevel": "IC 3",
      "benchmarkValues": [
        {
          "compensationType": "SALARY",
          "percentile": "P25",
          "benchmark": {
            "value": "100000"
          }
        },
        {
          "compensationType": "SALARY",
          "percentile": "P50",
          "benchmark": {
            "value": "110000"
          }
        },
        {
          "compensationType": "SALARY",
          "percentile": "P75",
          "benchmark": {
            "value": "120000"
          }
        },
        {
          "compensationType": "SALARY",
          "percentile": "P90",
          "benchmark": {
            "value": "130000"
          }
        }
      ]
    }
  ]
}
```