Skip to main content
Use GET /v1/compensation to retrieve named-executive records parsed from a definitive proxy (DEF 14A). Use POST /v1/compensation/compare only to compare the latest two parsable proxy disclosures for the same issuer. These routes normalize the Summary Compensation Table; they do not calculate realized pay, peer-group pay, pay-for-performance, or a cross-company comparison.

​
Retrieve current records

ticker or cik identifies the issuer; limit is bounded to 1 through 50. The list response contains records such as executiveName, roleTitle, year, salaryUsd, bonusUsd, stockAwardsUsd, optionAwardsUsd, nonEquityIncentiveUsd, totalUsd, accessionNumber, and provenance. The parser excludes director-compensation rows where it can identify them. Null component values mean the proxy table did not supply a parseable value, not zero compensation.

​
Compare two proxy disclosures

The comparison response identifies currentFilingDate and previousFilingDate and returns rows by executive with status, current/previous total pay, delta, and reported years. It requires two parsable DEF 14A filings. It does not accept a peer ticker list or two arbitrarily chosen filing periods.

​
Interpret and cite carefully

Summary Compensation Table values use SEC-prescribed categories and can include grant-date award values. They are not automatically cash received, award value at vesting, or total economic value realized. Retain the proxy accession, filing URL in provenance, fiscal year, and requestId; read the Compensation Discussion and Analysis, award terms, performance conditions, and footnotes before explaining a change. An empty list is a coverage outcome for the scanned filings, not proof that no executive compensation was disclosed. For an explicitly dated proxy, use filing search with form=DEF%2014A and cite the selected filing.

​
Next action

Start with current records, retain their source fields, and use the single-issuer comparison only when the latest two parsable proxy filings answer the question.