# Gloom Proxy Filing Lookup

> Gloom Proxy Filing Lookup is a paid API for AI agents from api.gloom.sh, paid per call via x402, $0.06/call, status unknown (last checked 2026-11-01).

Retrieves proxy filing data (DEF 14A) for one or more stock symbols, including CEO name, company details, fiscal year, and meeting date.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/exec-pay?utm_source=zero.xyz
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gloom-proxy-filing-lookup-847d6057
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QepAIIBI1VSjwu0_hl87u

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gloom-proxy-filing-lookup-847d6057
```

Example prompt: Pull up the proxy filing details for AAPL and MSFT — I want to see who the CEO is, what fiscal year the filing covers, and when the annual shareholder meeting is scheduled.

## When to prefer this

Choose this endpoint when you need structured proxy filing (DEF 14A) metadata for US-listed equities by ticker symbol, especially for corporate governance research, executive identification, or annual meeting scheduling. Prefer this over general SEC EDGAR queries when you want clean, pre-parsed proxy data with fiscal year and CEO fields ready to use.

## Known failure modes

- Invalid or unrecognized ticker symbol returns empty data array
- Missing required 'symbols' query parameter results in a 400-level error
- Payment not completed (x402 protocol) returns a 402 Payment Required response
- Rate limiting may apply if too many requests are made in a short period
- Proxy filing data may not be available for small-cap or foreign-listed stocks

## How this service works

Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.

## Output

Returns an array of proxy filing records, each containing: a unique filing ID, the stock symbol, CEO name, company details (CIK, full name, ticker, short name), filing date, proxy year, fiscal year, fiscal year label, meeting date, and last updated timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "symbols"
     ],
     "properties": {
      "symbols": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "id": "illustrative-proxy-0",
    "symbol": "AAPL",
    "ceoName": "Illustrative Executive",
    "company": {
     "cik": null,
     "name": "Illustrative Company",
     "ticker": "ILLUSTRATIVE",
     "shortName": "Illustrative Company"
    },
    "filedAt": "2026-03-30T12:00:00.000Z",
    "proxyYear": 2026,
    "updatedAt": "2026-09-30T12:00:00.000Z",
    "fiscalYear": 2025,
    "meetingDate": null,
    "fiscalYearLabel": "2025"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-proxy-filing-lookup-847d6057/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.gloom.sh](https://www.zero.xyz/host/api.gloom.sh/llms.txt)