Skip to content
Gridlode
Docs · Quickstart

Your first call in under a minute

Gridlode is a REST API over HTTPS. Every engine uses the same API key, the same credit wallet, and the same JSON envelope.

1. Get an API key

Create a free account. You get 1,000 credits and your first key immediately. Keys start with sk_live_; keep them secret and create one per app in the dashboard.

2. Make a request

Base URL: https://api.gridlode.com. Send the key as a bearer token and the parameters as a query string.

curl "https://api.gridlode.com/v1/domain/dns?domain=gridlode.com&types=A%2CMX%2CTXT" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

3. Read the response

Every successful call returns the same envelope. data holds the engine's result; everything else is the same for every engine.

200 OK
{
  "request_id": "req_3b6f0c2a9d1e4f7a8b9c0d1e",
  "engine": "domain.dns",
  "status": "success",
  "credits": { "charged": 1, "balance": 999 },
  "cache": { "hit": false, "age_seconds": 0 },
  "parameters": { "domain": "gridlode.com", "types": ["A", "MX", "TXT"] },
  "data": { "exists": true, "records": { "A": [ { "value": "104.21.0.1", "ttl": 300 } ] }, "consistent": true }
}

Errors use one shape and are never charged. See Errors.

Next steps