Account API

The Account API endpoint enables you to quickly query your account's state.

Request Parameters

• API Endpoint: GET https://serpgrid.dev/v1/account/state

• Required headers: X-API-KEY

Request Example

Account Check

// Example Request curl -L 'https://api.serpgrid.dev/v1/account/state' \ -H 'X-API-KEY: {API_KEY}'

Account Check

// Example Response { "http_code": 200, "http_message": "Ok", "timestamp": 1752787426, "execution_ms": 17, "message": "Successful execution", "payload": { "account": { "user": "email@domain.com", "plan": "Premium", "rps_limit": 10, "status": "Active", "credits": 45975, "credits_expire_at": "2025-08-18 11:32:30", "created_at": "2025-07-10 19:39:33" } } }

Useful Tip

Most of our APIs return response headers that will help you maintain proper accounting of your current credit status without needing to query this endpoint. These headers are:

• X-Credits-Remaining The number of credits that remain in your account
• X-Credits-Expire A datetime string with the expiration date
• X-Credits-Used The number of credits the operation consumed