Skip to content
Stored rates

Storage status

Operational status and record counts for the stored-rates service.

GET/v1/storage/status
Free

Request

GEThttps://api.scrapercompany.com/v1/storage/status

Authenticate with your API key in the x-api-key header (see Authentication).

Example request

curl "https://api.scrapercompany.com/v1/storage/status" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY"

Response

200 — Stored-rates service status and record counts.

200 response
{
  "database": {
    "tables": {
      "properties": 4,
      "property_source_identifiers": 4,
      "scrape_runs": 3,
      "rate_current": 51,
      "rate_history": 76,
      "refresh_jobs": 8,
      "refresh_job_items": 12,
      "request_history": 1842
    },
    "latest_run": {
      "run_id": "scraperun_0123456789abcdef0123456789abcdef",
      "status": "succeeded",
      "rows_written": 51,
      "rows_changed": 6,
      "rows_removed": 1,
      "finished_at": "2026-08-07 03:08:25.456+00"
    }
  },
  "r2_configured": true,
  "shared_cache_configured": true,
  "worker_archiving_enabled": true,
  "worker_persistence_enabled": true
}

Errors

Errors return a JSON body with a detail field. Failed requests are not charged. See Errors for the full list and retry advice.

StatusMeaningRetry?
401Unauthorized

Missing or invalid API key.

{"detail":"missing or invalid API key"}
No, fix the request
429Too Many Requests

Too many requests: the key's requests-per-minute limit was exceeded, or (once credit enforcement is on) the plan's concurrent-request limit. No rate-limit or Retry-After headers are sent; back off and retry.

{"detail":"rate limit 60/min exceeded"}
Yes, with backoff
503Service Unavailable

Temporarily unavailable: a dependency of this endpoint is down, or the upstream source changed its contract. Retry later.

{"detail":"database unavailable: OperationalError"}
Yes, with backoff

Try it

  1. Export your key: export SCRAPERCOMPANY_API_KEY=sk_... (no key yet? request access).
  2. Copy the cURL example above and run it in a terminal.
  3. Or open the interactive playground on api.scrapercompany.com, paste your key and pick this endpoint.