Velarion Company Intelligence

Look up executive compensation for a company in Velarion's coverage universe. Returns CEO/NEO total compensation, pay mix breakdown, and canonical metrics for the requested fiscal year (latest available if omitted). Every figure comes from the company's own disclosure and carries its citation. Out-of-coverage tickers return a structured error (not_in_coverage).

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "The company's ticker symbol (e.g. \"AAPL\")."
    },
    "fiscal_year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
    },
    "agent_token": {
      "default": "",
      "type": "string",
      "description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "company_name": {
      "type": "string"
    },
    "fiscal_year": {
      "type": "integer"
    },
    "executives": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Named executive officers with SCT pay components."
    },
    "ceo_percentile": {
      "type": "number"
    },
    "tsr_percentile": {
      "type": "number"
    },
    "p4p_gap": {
      "type": "number"
    },
    "error": {
      "type": "string"
    },
    "attribution": {
      "type": "object",
      "description": "Source citation, dataset DOI, and a ready-made cite_as string."
    }
  },
  "anyOf": [
    {
      "required": [
        "ticker"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}

Predict Say-on-Pay risk for a company using Velarion's deterministic risk compilers. Returns trend phrase, peer cohort distribution note, governance friction summary, and overall risk band, computed from disclosed vote results and compensation data.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "The company's ticker symbol (e.g. \"AAPL\")."
    },
    "fiscal_year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
    },
    "agent_token": {
      "default": "",
      "type": "string",
      "description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "risk_band": {
      "type": "string",
      "description": "Overall say-on-pay risk band."
    },
    "trend": {
      "type": "string",
      "description": "Trend phrase for the vote history."
    },
    "fiscal_year": {
      "type": "integer"
    },
    "error": {
      "type": "string"
    },
    "attribution": {
      "type": "object",
      "description": "Source citation, dataset DOI, and a ready-made cite_as string."
    }
  },
  "anyOf": [
    {
      "required": [
        "ticker"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}

Benchmark executive pay vs. disclosed peers using Velarion's canonical percentile data. Returns pay percentile, performance (TSR) percentile, pay-for-performance gap, and an alignment label. role is CEO-only.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "The company's ticker symbol (e.g. \"AAPL\")."
    },
    "role": {
      "default": "CEO",
      "type": "string",
      "description": "Optional executive role to benchmark (default CEO-only)."
    },
    "fiscal_year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
    },
    "agent_token": {
      "default": "",
      "type": "string",
      "description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "pay_percentile": {
      "type": "number"
    },
    "tsr_percentile": {
      "type": "number"
    },
    "p4p_gap_percentile_points": {
      "type": "number"
    },
    "alignment_label": {
      "type": "string",
      "description": "Pay-for-performance alignment label."
    },
    "peer_rank_caveat": {
      "type": "string"
    },
    "error": {
      "type": "string"
    },
    "attribution": {
      "type": "object",
      "description": "Source citation, dataset DOI, and a ready-made cite_as string."
    }
  },
  "anyOf": [
    {
      "required": [
        "ticker"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}

Compare multiple companies on pay, performance, and governance metrics. Returns a ranked table drawn from disclosed compensation, performance, and governance data. The summary describes observed patterns in the returned data only. Out-of-coverage tickers are excluded (listed separately). Max 20 tickers.

{
  "type": "object",
  "properties": {
    "tickers": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "description": "List of ticker symbols to compare (e.g. [\"AAPL\", \"MSFT\"]), max 20."
    },
    "fiscal_year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
    },
    "agent_token": {
      "default": "",
      "type": "string",
      "description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
    }
  },
  "required": [
    "tickers"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "comparisons": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Ranked pay/performance/governance table."
    },
    "error": {
      "type": "string"
    },
    "attribution": {
      "type": "object",
      "description": "Source citation, dataset DOI, and a ready-made cite_as string."
    }
  },
  "anyOf": [
    {
      "required": [
        "tickers"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}

Generate a Governance Alpha Card for a company. Composite deterministic card: pay alignment (Velarion's own P4P-style estimate, modeled on public peer-advisory methodology concepts — not licensed ISS data), governance scorecard, SoP risk band, peer quality, top risks/strengths. Requires the company to be in Velarion's coverage universe with current-period data. This tool was built as the free sample of the GOVERNANCE-ALPHA-CARD product. The owner killed that product (chat, 2026-09-24, verbatim "kill 15 through 41 … keep those 3"; docs/orders/ORDER_20260924_NON_AD7_KILL.md), so there is no longer a paid card to sample and no purchase path to offer. THE FREE TOOL STAYS (the order keeps every free page and free tool; only the buy option goes). Each agent may draw a limited number of cards per UTC day; beyond that the tool returns free_tier_cap_reached and nothing to buy. Structured errors returned (not raised) for: - not_in_coverage: ticker outside the covered universe - not_deliverable: the company's current-period disclosure does not support a card - free_tier_cap_reached: daily free allowance spent (wait for 00:00 UTC)

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "The company's ticker symbol (e.g. \"AAPL\")."
    },
    "year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
    },
    "agent_token": {
      "default": "",
      "type": "string",
      "description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "description": "e.g. deliverable, free_tier_cap_reached."
    },
    "risk_band": {
      "type": "string"
    },
    "governance_scorecard": {
      "type": "object"
    },
    "error": {
      "type": "string"
    },
    "attribution": {
      "type": "object",
      "description": "Source citation, dataset DOI, and a ready-made cite_as string."
    }
  },
  "anyOf": [
    {
      "required": [
        "ticker"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}

List the Velarion product catalog. Returns every available report with full detail by default (name, price, currency, delivery type, latency, caveats). Set `include_non_sellable=true` to also return products that are not currently on sale, each tagged with its status, so the full range is visible. A product with no settled price is returned with its status rather than a billable number.

{
  "type": "object",
  "properties": {
    "include_non_sellable": {
      "default": false,
      "type": "boolean",
      "description": "Also return products that are not currently on sale."
    },
    "agent_token": {
      "default": "",
      "type": "string",
      "description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "sellable": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Products currently on sale."
    },
    "counts": {
      "type": "object"
    },
    "non_sellable": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "error": {
      "type": "string"
    },
    "attribution": {
      "type": "object",
      "description": "Source citation, dataset DOI, and a ready-made cite_as string."
    }
  }
}

Free plan: executive compensation for a company in Velarion's covered universe. Returns Summary Compensation Table components for named executive officers, fiscal year 2022 forward, with a citation for each figure. No benchmark context, no percentiles, no narrative analysis; those are in the paid product.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "The company's ticker symbol (e.g. \"AAPL\")."
    },
    "fiscal_year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
    },
    "agent_token": {
      "default": "",
      "type": "string",
      "description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "attribution": {
      "properties": {
        "source": {
          "type": "string"
        },
        "company_page": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "dataset_doi": {
          "type": "string"
        },
        "doi_url": {
          "type": "string"
        },
        "cite_as": {
          "type": "string"
        },
        "filings": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        "reuse_terms": {
          "type": "string"
        }
      },
      "required": [
        "source",
        "company_page",
        "dataset_doi",
        "doi_url",
        "cite_as",
        "filings",
        "reuse_terms"
      ],
      "type": "object"
    },
    "ticker": {
      "type": "string"
    },
    "company_name": {
      "type": "string"
    },
    "industry": {
      "type": "string"
    },
    "fiscal_years_available": {
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "fiscal_year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ]
    },
    "executives": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "directors": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "unpaid_directors": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "fee_schedule": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "hold": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string"
    },
    "label": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "peers": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "say_on_pay_exempt": {
      "type": "boolean"
    },
    "ratio": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "median_employee_comp": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "ceo_total_comp": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "citation": {
      "additionalProperties": true,
      "type": "object"
    },
    "company_page": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "data_as_of": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "results": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "query": {
      "type": "string"
    },
    "truncated": {
      "type": "boolean"
    },
    "error": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    }
  },
  "required": [
    "attribution"
  ]
}

Free plan: non-employee director compensation and the board fee schedule. Unpaid directors (executive directors who serve without director fees) are listed separately from the paid table.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "The company's ticker symbol (e.g. \"AAPL\")."
    },
    "fiscal_year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
    },
    "agent_token": {
      "default": "",
      "type": "string",
      "description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "attribution": {
      "properties": {
        "source": {
          "type": "string"
        },
        "company_page": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "dataset_doi": {
          "type": "string"
        },
        "doi_url": {
          "type": "string"
        },
        "cite_as": {
          "type": "string"
        },
        "filings": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        "reuse_terms": {
          "type": "string"
        }
      },
      "required": [
        "source",
        "company_page",
        "dataset_doi",
        "doi_url",
        "cite_as",
        "filings",
        "reuse_terms"
      ],
      "type": "object"
    },
    "ticker": {
      "type": "string"
    },
    "company_name": {
      "type": "string"
    },
    "industry": {
      "type": "string"
    },
    "fiscal_years_available": {
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "fiscal_year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ]
    },
    "executives": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "directors": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "unpaid_directors": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "fee_schedule": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "hold": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string"
    },
    "label": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "peers": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "say_on_pay_exempt": {
      "type": "boolean"
    },
    "ratio": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "median_employee_comp": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "ceo_total_comp": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "citation": {
      "additionalProperties": true,
      "type": "object"
    },
    "company_page": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "data_as_of": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "results": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "query": {
      "type": "string"
    },
    "truncated": {
      "type": "boolean"
    },
    "error": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    }
  },
  "required": [
    "attribution"
  ]
}

Free plan: the company's own disclosed compensation peer group, most recent fiscal year on file.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "The company's ticker symbol (e.g. \"AAPL\")."
    },
    "agent_token": {
      "default": "",
      "type": "string",
      "description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "attribution": {
      "properties": {
        "source": {
          "type": "string"
        },
        "company_page": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "dataset_doi": {
          "type": "string"
        },
        "doi_url": {
          "type": "string"
        },
        "cite_as": {
          "type": "string"
        },
        "filings": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        "reuse_terms": {
          "type": "string"
        }
      },
      "required": [
        "source",
        "company_page",
        "dataset_doi",
        "doi_url",
        "cite_as",
        "filings",
        "reuse_terms"
      ],
      "type": "object"
    },
    "ticker": {
      "type": "string"
    },
    "company_name": {
      "type": "string"
    },
    "industry": {
      "type": "string"
    },
    "fiscal_years_available": {
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "fiscal_year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ]
    },
    "executives": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "directors": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "unpaid_directors": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "fee_schedule": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "hold": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string"
    },
    "label": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "peers": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "say_on_pay_exempt": {
      "type": "boolean"
    },
    "ratio": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "median_employee_comp": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "ceo_total_comp": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "citation": {
      "additionalProperties": true,
      "type": "object"
    },
    "company_page": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "data_as_of": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "results": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "query": {
      "type": "string"
    },
    "truncated": {
      "type": "boolean"
    },
    "error": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    }
  },
  "required": [
    "attribution"
  ]
}

Free plan: say-on-pay vote history. Support percentages are calculated by Velarion from disclosed vote counts (marked as such in the citation).

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "The company's ticker symbol (e.g. \"AAPL\")."
    },
    "agent_token": {
      "default": "",
      "type": "string",
      "description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "attribution": {
      "properties": {
        "source": {
          "type": "string"
        },
        "company_page": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "dataset_doi": {
          "type": "string"
        },
        "doi_url": {
          "type": "string"
        },
        "cite_as": {
          "type": "string"
        },
        "filings": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        "reuse_terms": {
          "type": "string"
        }
      },
      "required": [
        "source",
        "company_page",
        "dataset_doi",
        "doi_url",
        "cite_as",
        "filings",
        "reuse_terms"
      ],
      "type": "object"
    },
    "ticker": {
      "type": "string"
    },
    "company_name": {
      "type": "string"
    },
    "industry": {
      "type": "string"
    },
    "fiscal_years_available": {
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "fiscal_year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ]
    },
    "executives": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "directors": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "unpaid_directors": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "fee_schedule": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "hold": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string"
    },
    "label": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "peers": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "say_on_pay_exempt": {
      "type": "boolean"
    },
    "ratio": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "median_employee_comp": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "ceo_total_comp": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "citation": {
      "additionalProperties": true,
      "type": "object"
    },
    "company_page": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "data_as_of": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "results": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "query": {
      "type": "string"
    },
    "truncated": {
      "type": "boolean"
    },
    "error": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    }
  },
  "required": [
    "attribution"
  ]
}

Free plan: the most recent disclosed CEO pay ratio.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "The company's ticker symbol (e.g. \"AAPL\")."
    },
    "agent_token": {
      "default": "",
      "type": "string",
      "description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "attribution": {
      "properties": {
        "source": {
          "type": "string"
        },
        "company_page": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "dataset_doi": {
          "type": "string"
        },
        "doi_url": {
          "type": "string"
        },
        "cite_as": {
          "type": "string"
        },
        "filings": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        "reuse_terms": {
          "type": "string"
        }
      },
      "required": [
        "source",
        "company_page",
        "dataset_doi",
        "doi_url",
        "cite_as",
        "filings",
        "reuse_terms"
      ],
      "type": "object"
    },
    "ticker": {
      "type": "string"
    },
    "company_name": {
      "type": "string"
    },
    "industry": {
      "type": "string"
    },
    "fiscal_years_available": {
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "fiscal_year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ]
    },
    "executives": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "directors": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "unpaid_directors": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "fee_schedule": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "hold": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string"
    },
    "label": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "peers": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "say_on_pay_exempt": {
      "type": "boolean"
    },
    "ratio": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "median_employee_comp": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "ceo_total_comp": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "citation": {
      "additionalProperties": true,
      "type": "object"
    },
    "company_page": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "data_as_of": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "results": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "query": {
      "type": "string"
    },
    "truncated": {
      "type": "boolean"
    },
    "error": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    }
  },
  "required": [
    "attribution"
  ]
}

Free plan: search Velarion's covered universe by company name or ticker. Requires a query of at least two characters; returns at most 10 results.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Company name or ticker fragment, at least 2 characters (e.g. \"apple\")."
    },
    "agent_token": {
      "default": "",
      "type": "string",
      "description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "attribution": {
      "properties": {
        "source": {
          "type": "string"
        },
        "company_page": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "dataset_doi": {
          "type": "string"
        },
        "doi_url": {
          "type": "string"
        },
        "cite_as": {
          "type": "string"
        },
        "filings": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "type": "array"
        },
        "reuse_terms": {
          "type": "string"
        }
      },
      "required": [
        "source",
        "company_page",
        "dataset_doi",
        "doi_url",
        "cite_as",
        "filings",
        "reuse_terms"
      ],
      "type": "object"
    },
    "ticker": {
      "type": "string"
    },
    "company_name": {
      "type": "string"
    },
    "industry": {
      "type": "string"
    },
    "fiscal_years_available": {
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "fiscal_year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ]
    },
    "executives": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "directors": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "unpaid_directors": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "fee_schedule": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "hold": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string"
    },
    "label": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "peers": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "say_on_pay_exempt": {
      "type": "boolean"
    },
    "ratio": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "median_employee_comp": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "ceo_total_comp": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "citation": {
      "additionalProperties": true,
      "type": "object"
    },
    "company_page": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "data_as_of": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "results": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    },
    "query": {
      "type": "string"
    },
    "truncated": {
      "type": "boolean"
    },
    "error": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    }
  },
  "required": [
    "attribution"
  ]
}