API quickstart: make your first request
Set up API access and make authenticated requests for companies, metrics and filings.
1. Create an account
Register or sign in at the FinData account page. Account sign-in establishes your account session; it is not itself a reusable API bearer token. API requests need an OAuth access token issued for the API resource, or an existing operator key if you have been supplied one.
2. Obtain an API access token
Open the FinData API token page, choose Sign in and get a token, sign in or create an account, and approve the requested access. The page uses the OAuth authorization-code flow with PKCE and returns a short-lived access token for https://api.findata.com. Copy it and keep it private.
When the token expires, return to the token page and authorize again. The token is shown only in your current tab; it is not a permanent API key or stored for you. Never share a token or put it in source control. For your own OAuth client, registration and an approved redirect URI are still needed; the self-service token page avoids that requirement for manual bearer-token use.
3. Send an authenticated request
Replace YOUR_ACCESS_TOKEN with your actual token. Use an environment variable or a secret manager rather than embedding credentials in application code.
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
"https://api.findata.com/v1/companies?query=apple"The response contains a companies array. Search accepts 2–100 characters and returns at most 50 results. Results depend on imported data.
4. Explore a company
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
"https://api.findata.com/v1/companies/AAPL/filings"The filings endpoint returns up to 100 recent imported filings. Use the returned CIK where a ticker is ambiguous. See the API reference for the published endpoint descriptions; some implemented filing and structured routes are described in the help articles.