> ## Documentation Index
> Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Advanced Quickstarts

> Build real SEC API workflows beyond your first request, with practical end-to-end recipes instead of toy examples.

<Info>
  Use these once your first request works. Each quickstart is a small workflow you can keep in an integration, not a throwaway sample.
</Info>

## Pick the next job

<CardGroup cols={2}>
  <Card title="Compare 13F positions" icon="users" href="/api-reference/owners">
    Compare the latest two 13F reports for one institutional manager.
  </Card>

  <Card title="Compare executive compensation" icon="wallet-cards" href="/api-reference/compensation">
    Compare the latest two compensation disclosures for one issuer.
  </Card>

  <Card title="Search offerings activity" icon="briefcase-business" href="/api-reference/offerings">
    Pull recent S-1 and 424B prospectus activity without staying in EDGAR all day.
  </Card>

  <Card title="Inspect billing posture" icon="credit-card" href="/auth-and-pricing">
    Read billing state, public rates, and quote a workflow with an API key.
  </Card>
</CardGroup>

### Compare 13F positions

Use this when you know the institutional manager CIK and want the latest quarter-over-quarter position changes.

```bash theme={null}
curl -X POST \
  -H "content-type: application/json" \
  -H "x-api-key: $SECAPI_API_KEY" \
  https://api.secapi.ai/v1/owners/13f/compare \
  -d '{"cik":"0001067983","limit":25}'
```

### Compare executive compensation

Use this when you want the latest year-over-year compensation comparison for one issuer.

```bash theme={null}
curl -X POST \
  -H "content-type: application/json" \
  -H "x-api-key: $SECAPI_API_KEY" \
  https://api.secapi.ai/v1/compensation/compare \
  -d '{"ticker":"NVDA","limit":10}'
```

### Search offerings activity

Use this when you want recent registration statements or prospectus filings as structured rows.

```bash theme={null}
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/offerings?forms=S-1,424B4&limit=10"
```

### Inspect billing and quote a workflow

API keys can read billing state and quote usage. They cannot start Checkout, open the Billing Portal, save payment methods, enable PAYG, top up credits, or change budgets.

```bash theme={null}
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/billing"

curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/billing/rates"

curl -X POST \
  -H "content-type: application/json" \
  -H "x-api-key: $SECAPI_API_KEY" \
  https://api.secapi.ai/v1/billing/quote \
  -d '{"path":"/v1/offerings","method":"GET","units":10}'
```

For browser-session billing changes, sign in at `https://secapi.ai/login` and use the dashboard Billing and Credits area. Checkout, Billing Portal, payment-method setup, PAYG activation, credit top-ups, auto top-up, refunds, and budget changes require a WorkOS browser session with billing permissions.

<Prompt>
  Take the next SEC API workflow after the first request. Choose one of: compare 13F positions, compare executive compensation, search offerings activity, or inspect billing and quote a workflow. Implement it with the exact endpoint, preserve requestId and freshness metadata when present, and summarize the result in markdown. For billing mutations, direct the user to the signed-in dashboard instead of using an API-key curl.
</Prompt>