Skip to content
APIAPI reference

Runs

Your calls to POST /v2/run, as they were sent and answered.

List your calls

GEThttps://api.lobstr.io/v2/runs

Your calls to POST /v2/run, newest first, kept 90 days: what was sent and what was answered, records aside.

Parameters
limitintegerqueryDefault 20
starting_afterstringquery
The last id of the previous page; next writes it for you.
operationstringquery
Only this operation, as google_maps/reviews/list.
status"succeeded" | "failed"query
via"api" | "mcp" | "app"query
Only the calls made by the API, the MCP server or the app.
created_afterstringquery
UTC, as 2026-11-09T08:00:00Z.
created_beforestringquery
UTC, as 2026-11-09T08:00:00Z.
Answer 200
object"list"required
has_morebooleanrequired
nextstring | nullrequired
The following page's path, whole: call it as it is.
dataRun[]required

Anything else answers an error.

curl https://api.lobstr.io/v2/runs \
  -H "Authorization: Bearer $LOBSTR_API_KEY"

Read a call

GEThttps://api.lobstr.io/v2/runs/{run_id}

One of your calls: what was sent and what was answered, records aside.

Parameters
run_idstringpathrequired
Answer 200
object"run"required
idstringrequired
created_atstringrequired
via"api" | "mcp" | "app"required
sourcestringrequired
operationstringrequired
versionstring | null
status"succeeded" | "failed"required
http_statusintegerrequired
requestobjectrequired
errorobject
A failed call's error, as it answered it: type, code, message, param, doc_url, request_id, retryable.
costobject
duration_msintegerrequired
request_idstringrequired
responseobject | null
Where the whole answer is read (url, null once expired) and until when; null for a failed call.

Anything else answers an error.

curl https://api.lobstr.io/v2/runs/run_dp5kejuoabgahbabqw4p77jqi4 \
  -H "Authorization: Bearer $LOBSTR_API_KEY"

Read a call's whole answer

GEThttps://api.lobstr.io/v2/runs/{run_id}/response

A call's whole answer as it was sent, records included, while your plan keeps answers (7, 45 or 90 days).

Parameters
run_idstringpathrequired
Answer 200
objectstringrequired
idstringrequired
created_atstring
livemodeboolean
sourcestringrequired
operationstringrequired
versionstringrequired
schema_urlstring
optionsobject
statusstringrequired
countintegerrequired
has_morebooleanrequired
nextgoogle_maps.places.get.Request | nullrequired
The whole call for the following page: send it as it is.
costobjectrequired
balanceobject
duration_msinteger
request_idstringrequired
resultsgoogle_maps.places.get.Record[]required

Anything else answers an error.

curl https://api.lobstr.io/v2/runs/run_dp5kejuoabgahbabqw4p77jqi4/response \
  -H "Authorization: Bearer $LOBSTR_API_KEY"