# API keys

import { Card } from "zudoku/ui/Card";
import { BookOpen, Coins } from "zudoku/icons";
import { GET_API_KEY_URL } from "../site/links";

Use an [API key](/definitions), your account credential, to authenticate calls.

## Get and manage your key

Open <a href={GET_API_KEY_URL}>Developers → Keys</a> to create or revoke a key.
Creating a key needs a saved card. Rotating or revoking a key does not.
Developers → Keys shows your current key’s masked prefix; press **Reveal key** to view the full key again. It hides after 60 seconds or when you leave.

A missing or invalid key receives [`401 invalid-key`](/errors/invalid-key), and nothing is charged.
Your [balance](/balance) is the money in dollars available to spend now.

## Distinguish keys from your balance

A valid API Key with an empty Balance still authenticates. The request is then refused
as [`402 insufficient-credits`](/errors/insufficient-credits) — a different error,
with a different fix. `401` means fix the key; `402` means add funds.

`POST /v1/validate` needs a valid key and works at zero Balance without spending.

## Rotate or revoke a key

Press **Rotate key** in Developers → Keys yourself; the replacement appears in full.
Rotation leaves your Balance and Tier unchanged and charges nothing.

A revoked API Key can continue to authenticate for up to **~60 seconds** after
revocation — the gateway holds a short-lived key cache — and within a minute it stops
everywhere. If you are rotating credentials on a schedule, treat that minute as part
of the rotation window: issue the new key, move traffic, then revoke the old one.

:::warning[If calls must stop now]
Ask us to **zero your Balance**: contact `support@investorliftdata.com`.
A zero Balance refuses charged calls on the request itself, independently of key-cache propagation.

Your history stays intact, and you can add funds again afterwards.
Revoke the key as well: zeroing stops spending; revocation retires the credential.
:::

## Submitted addresses

Submitted address data is never sold, never shared between customers, and never used to build or market a competing acquisition list. [Terms of Service](https://investorliftdata.com/terms).

## Next steps

<div className="docs-next-steps">

<Card className="docs-next-card"><a href="/quickstart"><BookOpen className="docs-next-icon" size={18} strokeWidth={1.5} aria-hidden="true" focusable="false" /><strong>Quickstart</strong><span className="docs-next-description">Make your first scored call.</span><span className="docs-next-arrow" aria-hidden="true">→</span></a></Card>

<Card className="docs-next-card"><a href="/balance"><Coins className="docs-next-icon" size={18} strokeWidth={1.5} aria-hidden="true" focusable="false" /><strong>Your balance</strong><span className="docs-next-description">Understand charges and money returned to your balance.</span><span className="docs-next-arrow" aria-hidden="true">→</span></a></Card>

</div>