RentSeek Evidence

Returns annual named-executive compensation rows for a company identified by ticker or CIK, with fiscal-year filters, pay components, totals, and filing source URLs. Latest-FY requests cost 0 credits; historical, range, or multi-FY requests require OAuth or X-API-KEY and cost 1 credit. Pay ratio, pay-versus-performance, and company dossiers are not included. The result is filing data, not investment advice.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "minLength": 1
    },
    "cik": {
      "type": "string",
      "minLength": 1
    },
    "period": {
      "default": "annual",
      "type": "string",
      "const": "annual"
    },
    "limit": {
      "default": 1,
      "description": "Maximum fiscal years to return. Defaults to the latest year only.",
      "type": "integer",
      "minimum": 0,
      "maximum": 100
    },
    "fiscal_year": {
      "description": "Exact fiscal year. Omit all fiscal-year filters to get the latest year.",
      "type": "integer",
      "minimum": 1900,
      "maximum": 2100
    },
    "fiscal_year_lte": {
      "description": "Inclusive latest fiscal year. Omit all fiscal-year filters to get the latest year.",
      "type": "integer",
      "minimum": 1900,
      "maximum": 2100
    },
    "fiscal_year_gte": {
      "description": "Inclusive earliest fiscal year. Omit all fiscal-year filters to get the latest year.",
      "type": "integer",
      "minimum": 1900,
      "maximum": 2100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns a sourced company dossier for a ticker, including executives, compensation history, pay ratio, pay-versus-performance, claims, and release provenance, with optional full or compact format and field projection. Requires OAuth or X-API-KEY and costs 3 credits. The result is filing evidence, not investment advice.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "minLength": 1
    },
    "format": {
      "default": "full",
      "type": "string",
      "enum": [
        "full",
        "compact"
      ]
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "company",
          "release",
          "methodology_version",
          "executives",
          "compensation_history",
          "pay_ratio",
          "pay_vs_performance",
          "claims",
          "sources",
          "limitations"
        ]
      }
    }
  },
  "required": [
    "ticker"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns the value, filing source, release identity, methodology version, and current or superseded status for a RentSeek `clm_...` claim ID. Requires OAuth or X-API-KEY and costs 1 credit. The result is filing evidence, not investment advice.

{
  "type": "object",
  "properties": {
    "claim_id": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "claim_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns classified executive-compensation disclosure changes for 1-50 tickers since an inclusive date or timestamp, with configurable thresholds and cursor pagination. Requires OAuth or X-API-KEY and costs 2 credits per page. Current compensation snapshots and full historical rows are not included. The result is filing evidence, not investment advice.

{
  "type": "object",
  "properties": {
    "tickers": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "Ticker symbols to monitor. Pass 1-50 symbols in one request."
    },
    "since": {
      "type": "string",
      "minLength": 1,
      "description": "Inclusive ISO date or timestamp from the caller's prior feed run."
    },
    "threshold_total_pct": {
      "default": 20,
      "description": "Material total-compensation change percent. Omit to use 20%.",
      "type": "number",
      "minimum": 0,
      "maximum": 10000
    },
    "threshold_component_pct": {
      "default": 30,
      "description": "Material compensation-component change percent. Omit to use 30%.",
      "type": "number",
      "minimum": 0,
      "maximum": 10000
    },
    "classification": {
      "default": "material",
      "description": "Event classification to return. Omit to return material events only; use all to include informational events.",
      "type": "string",
      "enum": [
        "material",
        "all"
      ]
    },
    "page_size": {
      "default": 25,
      "description": "Events per page. Omit to use 25; maximum 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "Opaque next_cursor from a prior response. Omit for the first page.",
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "tickers",
    "since"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns ticker symbols for companies with published RentSeek executive-compensation data. No authentication is required, and the request costs 0 credits. The result contains availability only, not compensation values. It is not investment advice.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Accepts a structured product-feedback report with category, message, and optional URL, route, tool, request ID, trace ID, or reproducible context. Returns an opaque report ID. Human triage owns disposition. Secret-bearing, oversize, or malformed payloads are rejected without persist. Authentication is optional; anonymous submissions are rate-limited. The request costs 0 credits. The result is a receipt for human triage, not investment advice.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "bug",
        "data_quality",
        "docs",
        "api",
        "mcp",
        "other"
      ]
    },
    "message": {
      "type": "string",
      "minLength": 10,
      "maxLength": 2000
    },
    "url": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "route": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "tool": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "request_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "trace_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "context": {
      "type": "object",
      "properties": {
        "ticker": {
          "type": "string",
          "pattern": "^(?=.*[A-Z])[A-Z0-9][A-Z0-9.\\s-]{0,29}$"
        },
        "fiscal_year": {
          "type": "integer",
          "minimum": 1900,
          "maximum": 2100
        },
        "executive_id": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        }
      },
      "additionalProperties": false
    }
  },
  "required": [
    "category",
    "message"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "schema_version": {
      "type": "string",
      "const": "feedback/v1"
    },
    "id": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "const": "accepted"
    }
  },
  "required": [
    "schema_version",
    "id",
    "status"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}