Retrieve your account

GET /v1/me

Returns the account the key belongs to. Use it as your connection test. A 200 means the key is valid and active. The call costs no credits and is not written to your query history. It counts as one request against the key’s rate limit.

curl https://api.serpresult.com/v1/me \
  -H "Authorization: Bearer $SERP_API_KEY"

const response = await fetch("https://api.serpresult.com/v1/me", {
  headers: { Authorization: `Bearer ${process.env.SERP_API_KEY}` },
});
if (response.status === 401) throw new Error("Invalid or revoked API key");
const account = await response.json();

import os, requests

response = requests.get(
    "https://api.serpresult.com/v1/me",
    headers={"Authorization": f"Bearer {os.environ['SERP_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
account = response.json()

Response

{
  "email": "[email protected]",
  "plan": "growth",
  "credits_available": 48210,
  "api_key": {
    "id": "key_3f2a9c1e7b4d4e8a9f602c1d8e5b7a90",
    "label": "Zapier",
    "mode": "live"
  }
}

Field	Description
`email`	The email address of the account that owns the key.
`plan`	The account’s plan: `trial`, `starter`, `growth`, `business` or `enterprise`.
`credits_available`	Your plan’s remaining credits for the period plus your credit-pack balance. The dashboard shows the same total.
`api_key.id`	The id of the key that made the call. It matches the key’s row on the API Keys page.
`api_key.label`	The name you gave the key when you created it.
`api_key.mode`	`live` or `test`, the type you picked when you created the key.

A request made with a signed-in dashboard session instead of a key gets api_key: null.

Errors

Status	Code	When
`401`	`unauthorized`	The key is missing, malformed, revoked, or not one we issued.
`429`	`rate_limited`	The key’s per-minute rate limit is spent. Wait `Retry-After` seconds.

Both use the standard error envelope.

See also

Authentication covers live and test keys, rotation and revocation
Rate limits lists the per-minute ceiling for each credential
Pricing & quotas explains plan credits and credit packs