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 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"
          }
        }
      ]
    }
  ]
}