Skip to content

Deliver a completed data request result once

Collections
post /v1/data-requests/{dataRequestId}/result

Returns the completed result once and atomically marks it delivered. Queued or running requests are not ready. Failed requests return a safe failure envelope. No additional charge occurs.

Authentication

  • ApiKey bearer token

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

Path parameters

  • dataRequestId string · uuid required

    The data request ID returned when a refresh is accepted.

Responses

  • 200

    The completed data request result, delivered once. A failed request returns its safe error envelope.

  • 400

    The request failed validation.

  • 401

    The bearer credential is missing or invalid.

  • 403

    The key cannot perform this operation.

  • 404

    The organization-owned data request was not found.

  • 409

    The data request is not ready or was already delivered.

  • 429

    The Cloudflare rate limiter rejected the request.

  • 500

    The request failed without exposing internal diagnostics.

  • 503

    A required service is unavailable.