Executive pay

One proxy year: CEO pay, named executives, pay ratio.

Routes

Base URL https://api.gloom.sh. Send a key with each call; the key's account needs a plan.

GET /v1/exec-pay/{symbol}

Available executive compensation filings. Reads stored data only and needs a key on an account with a plan; every plan reads every live dataset in full. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter: symbol
In: path, required
Type: string ^[A-Za-z0-9.:-]{1,32}$
Notes: Company symbol; normalized to uppercase.

Parameter	In	Type	Notes
`symbol`	path, required	string `^[A-Za-z0-9.:-]{1,32}$`	Company symbol; normalized to uppercase.

Credits: 2 (lookup x2)
Plans: Basic, Desk, Enterprise

GET /v1/exec-pay/{symbol}/{year}

Executive compensation for a filing year. Reads stored data only and needs a key on an account with a plan; every plan reads every live dataset in full. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter: symbol
In: path, required
Type: string ^[A-Za-z0-9.:-]{1,32}$
Notes: Company symbol; normalized to uppercase.

Parameter: year
In: path, required
Type: integer 1900 to 2100

Parameter	In	Type	Notes
`symbol`	path, required	string `^[A-Za-z0-9.:-]{1,32}$`	Company symbol; normalized to uppercase.
`year`	path, required	integer 1900 to 2100

Credits: 10 (evidence x2)
Plans: Basic, Desk, Enterprise

Example response

Synthetic values, marked in meta. GET /v1/datasets/exec-pay/sample returns it with no key and no account.

json

{
  "data": {
    "company": {
      "ticker": "ILLUSTRATIVE",
      "cik": null,
      "name": "Illustrative Company",
      "shortName": "Illustrative Company"
    },
    "proxies": [
      {
        "id": "illustrative-proxy-0",
        "ticker": "ILLUSTRATIVE",
        "company": {
          "ticker": "ILLUSTRATIVE",
          "cik": null,
          "name": "Illustrative Company",
          "shortName": "Illustrative Company"
        },
        "proxyYear": 2026,
        "fiscalYear": 2025,
        "fiscalYearLabel": "2025",
        "filedAt": "2026-03-30T12:00:00.000Z",
        "meetingDate": null,
        "updatedAt": "2026-09-30T12:00:00.000Z",
        "ceoName": "Illustrative Executive",
        "ceoTitle": "Chief Executive Officer",
        "ceoTotal": 1000000,
        "ceoPriorYearTotal": null,
        "payRatio": null,
        "medianEmployeePay": null
      },
      {
        "id": "illustrative-proxy-1",
        "ticker": "ILLUSTRATIVE",
        "company": {
          "ticker": "ILLUSTRATIVE",
          "cik": null,
          "name": "Illustrative Company",
          "shortName": "Illustrative Company"
        },
        "proxyYear": 2025,
        "fiscalYear": 2024,
        "fiscalYearLabel": "2024",
        "filedAt": "2025-03-30T12:00:00.000Z",
        "meetingDate": null,
        "updatedAt": "2026-09-30T12:00:00.000Z",
        "ceoName": "Illustrative Executive",
        "ceoTitle": "Chief Executive Officer",
        "ceoTotal": 1000000,
        "ceoPriorYearTotal": null,
        "payRatio": null,
        "medianEmployeePay": null
      },
      {
        "id": "illustrative-proxy-2",
        "ticker": "ILLUSTRATIVE",
        "company": {
          "ticker": "ILLUSTRATIVE",
          "cik": null,
          "name": "Illustrative Company",
          "shortName": "Illustrative Company"
        },
        "proxyYear": 2024,
        "fiscalYear": 2023,
        "fiscalYearLabel": "2023",
        "filedAt": "2024-03-30T12:00:00.000Z",
        "meetingDate": null,
        "updatedAt": "2026-09-30T12:00:00.000Z",
        "ceoName": "Illustrative Executive",
        "ceoTitle": "Chief Executive Officer",
        "ceoTotal": 1000000,
        "ceoPriorYearTotal": null,
        "payRatio": null,
        "medianEmployeePay": null
      }
    ]
  },
  "meta": {
    "dataset": "exec-pay",
    "asOf": null,
    "source": [
      {
        "id": "sec-edgar",
        "attribution": "U.S. Securities and Exchange Commission and the filing issuer",
        "licence": "Public SEC filings; preserve filing attribution and fair-access limits"
      }
    ],
    "historyStarts": null,
    "coverage": null,
    "lastUpdated": null,
    "sample": true,
    "note": "ILLUSTRATIVE: synthetic examples showing the response fields; not real company disclosures or published observations."
  }
}

Meta fields

Field: dataset
Here: The dataset id
In the example: "exec-pay"

Field: asOf
Here: The newest filing time in the response
In the example: null

Field: source
Here: Attribution and licence of each source
In the example: 1 source

Field: historyStarts
Here: Earliest stored history when established by the service; otherwise null.
In the example: null, not stated yet

Field: coverage
Here: Service-established coverage; null when unavailable.
In the example: null

Field: lastUpdated
Here: When the proxy record was last updated
In the example: null

Field	Here	In the example
`dataset`	The dataset id	`"exec-pay"`
`asOf`	The newest filing time in the response	null
`source`	Attribution and licence of each source	1 source
`historyStarts`	Earliest stored history when established by the service; otherwise null.	null, not stated yet
`coverage`	Service-established coverage; null when unavailable.	null
`lastUpdated`	When the proxy record was last updated	null

Sources

Source: U.S. Securities and Exchange Commission and the filing issuer
Licence: Public SEC filings; preserve filing attribution and fair-access limits

Source	Licence
U.S. Securities and Exchange Commission and the filing issuer	Public SEC filings; preserve filing attribution and fair-access limits

Errors

These routes can answer 400, 401, 402, 403, 404, 429, 503. See Errors for the codes.

Gloom Datasets reads stored data only: a call never starts a collection.