Productsup
CDE APIApi referenceBuckets

List buckets

Integrators can only list their own buckets

Sign in to run requests against the CDE API.
GET
/buckets

Authorization

oAuth2AuthCode
AuthorizationBearer <token>

In: header

Query Parameters

owner?string

filter by owner's email address

from?integer

starting item

limit?integer

items per page

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://cde.staging.productsup.com/buckets"
{
  "data": [
    {
      "id": "48ba5075-64d2-4198-bd1d-de2869dc94b6",
      "name": "bucket1",
      "owner": "019e16f3-cf2f-7c8e-b8a6-917538ba273e",
      "created-at": "2026-05-11T14:12:17+02:00"
    },
    {
      "id": "a1c81f79-4628-4cd3-b3c2-ffab65c31194",
      "name": "bucket2",
      "owner": "019e16f3-cf2f-7c8e-b8a6-917538ba273e",
      "created-at": "2026-05-11T14:12:17+02:00"
    },
    {
      "id": "aeb2d9d6-c313-4188-837a-7a2f6425bbea",
      "name": "bucket3",
      "owner": "019e16f3-cf2f-7c8e-b8a6-917538ba273e",
      "created-at": "2026-05-11T14:12:17+02:00"
    },
    {
      "id": "6333bb12-d1ec-4f7c-bac9-fb6b7a27330d",
      "name": "bucket4",
      "owner": "019e16f3-cf2f-704a-b8a6-91753831cdce",
      "created-at": "2026-05-11T14:12:17+02:00"
    },
    {
      "id": "dda2bc66-1019-4e32-8ae6-44608e2b7152",
      "name": "bucket5",
      "owner": "019e16f3-cf2f-704a-b8a6-91753831cdce",
      "created-at": "2026-05-11T14:12:17+02:00"
    },
    {
      "id": "9582622a-e49d-4145-b831-912ed74c8e38",
      "name": "bucket6",
      "owner": "019e16f3-cf2d-7b8e-a297-759dd0458a40",
      "created-at": "2026-05-11T14:12:17+02:00"
    },
    {
      "id": "989c0302-7a79-4403-ad71-22f68c6f9bb7",
      "name": "bucket7",
      "owner": "019e16f3-cf37-7a36-ae96-1667a74e08b5",
      "created-at": "2026-05-11T14:12:17+02:00"
    },
    {
      "id": "362c4f0f-325d-4912-84c2-4ea00dd0c193",
      "name": "bucket8",
      "owner": "019e16f3-cf3a-73e2-848f-82f04b9adc56",
      "created-at": "2026-05-11T14:12:17+02:00"
    },
    {
      "id": "7d68d3c2-90ad-496d-b5f2-ec1200071ac4",
      "name": "bucket9",
      "owner": "019e16f3-cf4a-79ff-83d9-38e89e4bf5d1",
      "created-at": "2026-05-11T14:12:17+02:00"
    },
    {
      "id": "40d1411d-21bf-47ce-bba3-673b963ed434",
      "name": "bucket10",
      "owner": "019e16f3-cf3a-73e2-848f-82f04b9adc56",
      "created-at": "2026-05-11T14:12:17+02:00"
    },
    {
      "id": "8b297b6e-3ec7-4d82-a9f6-d5427f696231",
      "name": "bucket11",
      "owner": "019e16f3-cf58-7364-82b6-364a99b55c4a",
      "created-at": "2026-05-11T14:12:17+02:00"
    }
  ],
  "metadata": {
    "from": 0,
    "limit": 100,
    "count": 11,
    "total": 11,
    "next": null
  },
  "message": "successful operation",
  "resource": "bucket"
}
{
  "message": "Invalid connector user identifier.",
  "errors": []
}
{
  "message": "You have to be authorized to access this resource."
}
{
  "message": "Access denied for user."
}

How is this guide?