> ## 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.

# Try it

> Make a live SEC API request, inspect the issuer response, and continue to a source filing

Use this page to make a small live request before you build a larger workflow. Resolve a company first, then use the returned identity to choose the filing, statement, or search request you need.

<Warning>
  These examples call the production API and count against your usage quota.
</Warning>

## Set your API key

Create an account at [secapi.ai/signup](https://secapi.ai/signup), create an API key in the signed-in [dashboard](https://secapi.ai/app), and expose it only to the process making the request.

```bash theme={null}
export SECAPI_API_KEY="secapi_..."
```

Send the key in `x-api-key`. Do not put it in browser code, a checked-in file, or an `Authorization: Bearer` header.

## Resolve a company

This request resolves Apple and returns its canonical CIK and identity metadata. `id` is SEC API's opaque canonical identifier for the resolved issuer; only `requestId` varies by request.

<CodeGroup>
  ```bash cURL theme={null}
  curl -sS \
    -H "x-api-key: $SECAPI_API_KEY" \
    "https://api.secapi.ai/v1/entities/resolve?ticker=AAPL&view=agent"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://api.secapi.ai/v1/entities/resolve?ticker=AAPL&view=agent",
    { headers: { "x-api-key": process.env.SECAPI_API_KEY } },
  )

  const entity = await response.json()
  console.log(entity.ticker, entity.cik, entity.name, entity.requestId)
  ```

  ```python Python theme={null}
  import os

  import requests

  response = requests.get(
      "https://api.secapi.ai/v1/entities/resolve",
      params={"ticker": "AAPL", "view": "agent"},
      headers={"x-api-key": os.environ["SECAPI_API_KEY"]},
  )
  entity = response.json()
  print(entity["ticker"], entity["cik"], entity["name"], entity["requestId"])
  ```

  ```bash CLI theme={null}
  secapi entities resolve --ticker AAPL
  ```
</CodeGroup>

On success, confirm that the result includes `ticker`, `cik`, `name`, and `requestId`. Keep the request ID with your logs. For the complete set of accepted identifiers and response fields, read the [entity resolution reference](/api-reference/entities/get-v1-entities-resolve).

## Retrieve a filing

Once entity resolution works, retrieve the latest 10-K. The filing can change as new reports arrive, so retain the source fields from the response rather than expecting a fixed accession number.

```bash theme={null}
curl -sS \
  -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/filings/latest?ticker=AAPL&form=10-K&view=agent"
```

Keep `accessionNumber`, `filingDate`, `filingUrl`, and `requestId` with any result derived from the filing. The [latest filing reference](/api-reference/filings/get-v1-filings-latest) documents the available filters and response shape.

## Pick the next page

<CardGroup cols={3}>
  <Card title="Build an application" icon="blocks" href="/libraries-and-sdks">
    Choose an SDK for JavaScript, Python, Go, or Rust application code.
  </Card>

  <Card title="Work from a terminal" icon="terminal" href="/cli">
    Use the CLI for shell scripts and interactive investigation.
  </Card>

  <Card title="Use an MCP client" icon="bot" href="/mcp-install">
    Connect hosted MCP for source-backed research workflows.
  </Card>
</CardGroup>

Read [API conventions](/api-conventions) before adding pagination, version pinning, or retry logic. Read [Troubleshooting](/troubleshooting) when a request returns an error.