---
title: "Get Bucket Path"
method: GET
path: "/api/v1/block/arns/bucket-path"
tags: ["User APIs", "block-data"]
---

# Get Bucket Path

`GET /api/v1/block/arns/bucket-path`

The S3 bucket to surface in the "you'll have access to <bucket>" hint, or
null if none is provisioned yet. Bucket identity is not client-specific, so
this is gated only by Enterprise + Block role (not client-scoped).

``catalog`` selects both the row to match and how: a dataset can have rows in
both catalogs, so it must be an explicit input rather than inferred.

- Bulk flow (default, ``catalog=bulk``): exact SKU match on (dataset_id, lag,
  cut) within the bulk catalog.
- Sample flow (``catalog=sample``): sample access is lag-agnostic, so resolve
  the dataset's sample bucket rather than an exact SKU.

## Query parameters

- `dataset_id` string, required
- `lag` string, nullable
- `cut` string, nullable
- `catalog` string

## Response `200`

Successful Response

- BucketPathResponse — ``GET /block/arns/bucket-path`` — the provisioned S3 bucket for a SKU. ``bucket_path`` is ``None`` when no bucket has been provisioned for the (dataset_id, lag, cut) yet (the UI then shows a "not provisioned" hint).
  - `bucket_path` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)