Skip to content
Docs
Async jobs

Get a destination

One saved bucket for this account, with the secret access key withheld.

GET/v1/async/destinations/{destination_id}
FreeTry it

Request

GEThttps://api.scrapercompany.com/v1/async/destinations/{destination_id}

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

Run this request on your own API key from this page, with the values you type. Signed out? Sign in or get an API key.

Parameters

  • destination_idstringpathrequired

Example request

curl "https://api.scrapercompany.com/v1/async/destinations/asyncdst_0123456789abcdef0123456789abcdef" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY"

Response

200 — Saved destination; the secret is never returned.

200 response
{
  "id": "asyncdst_0123456789abcdef0123456789abcdef",
  "name": "nightly-comp-set",
  "kind": "s3",
  "bucket": "acme-rate-archive",
  "prefix": "scrapercompany",
  "region": "us-east-1",
  "endpoint": "https://s3.us-east-1.amazonaws.com",
  "path_style": false,
  "format": "jsonl",
  "access_key_id": "...3456",
  "secret_configured": true,
  "created_at": "2026-10-22T09:00:00Z",
  "updated_at": "2026-10-22T09:00:00Z"
}

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
404Not Found

The property, stay, job or record was not found.

{"detail":"job not found"}
No, fix the request
422Unprocessable Content

Request validation failed.

{"detail":[{"loc":["body","token"],"msg":"Field required","type":"missing"}]}
No, fix the request
429Too Many Requests

Too many requests: the key's requests-per-minute limit was exceeded, or (in enforce credits mode) 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

Press Try it above to run this request on your own key, with the values you type (sign in first). For a no-code walkthrough, use the workspace’s guided Try it.

  1. Export your key: export SCRAPERCOMPANY_API_KEY=sk_... (no key yet? start a free trial).
  2. Copy the cURL example above and run it in a terminal.

Questions about this page?

Send the page link and your question, and the team will answer.

Email support