Skip to content
Benchmark

Get collection status

Collections
get /v1/collections/{collectionId}

Returns pending or failed status, or delivers current stored data once after collection succeeds. Later polls return COLLECTION_ALREADY_DELIVERED.

Authentication

  • ApiKey bearer token

    Send the current Benchmark API key only in the Authorization header.

Path parameters

  • collectionId string · uuid required

    The collection ID. It is the `id` that a refresh returns.

Responses

  • 200

    The collection status and available result.

  • 400

    The request failed validation.

  • 401

    The bearer credential is missing or invalid.

  • 402

    The organization needs plan or purchased-credit entitlement, has reached its separate monthly spend cap, or cannot cover the operation within the entitled grace floor.

  • 403

    The key cannot perform this operation.

  • 404

    The organization-owned collection was not found.

  • 409

    The collection data was already delivered by an earlier poll.

  • 429

    The Cloudflare rate limiter rejected the request.

  • 500

    The request failed without exposing internal diagnostics.

  • 503

    A required service is unavailable.