Limai Docs
API ReferenceBuckets

Get Bucket

Get details of a specific bucket

GET/api/v1/buckets/{bucketId}

Returns detailed information about a specific bucket including file count.

Parameters

NameTypeInRequiredDescription
bucketIdstringpathYesThe bucket ID

Request

const res = await fetch(
"https://app.limai.io/api/v1/buckets/bkt_abc123",
{
  headers: {
    Authorization: "Bearer YOUR_API_TOKEN",
  },
}
);
const bucket = await res.json();

Response

Response200
{
  "id": "bkt_abc123",
  "name": "Raw Invoices",
  "description": "Incoming invoice files",
  "projectId": "proj_001",
  "fileCount": 42,
  "createdAt": "2025-01-01T00:00:00.000Z",
  "updatedAt": "2025-01-15T00:00:00.000Z"
}