v1.0
Version v1.0
Returns a flat brands array. No filtering or pagination parameters.
GET
Get catalog
Retrieve a comprehensive list of available brands and products assigned to your account.
GET
/api/integration/v1.0/catalogFollow this flow to place your first order
View all steps1
Get catalog
Discover available products
2
Get accounts
Retrieve your accounts
3
Place order
Create an order for your customer
4
Get order
Check order status
5
Notification
Receive webhook updates
This endpoint returns a flat brands array. Use it to discover available products, denominations, and pricing before placing an order.
This endpoint requires Basic Auth using your API credentials.
Response specifications
The v1 catalog response returns a flat brands array. Each brand includes its products.
| Field | Type | Description |
|---|---|---|
brands | array | List of all available brands and their products. |
internalId | string | Bamboo internal brand identifier. |
name | string | Brand name. |
countryCode | string | Brand country code. |
currencyCode | string | Brand currency code. |
description | string | null | Brand description. This value can be empty. |
disclaimer | string | null | Brand disclaimer. This value can be empty. |
redemptionInstructions | string | null | Redemption instructions. This value can be empty. |
terms | string | null | Brand terms. This value can be empty. |
logoUrl | string | Brand logo URL. |
modifiedDate | string | Last catalog update timestamp for the brand. |
products | array | Products available under the brand. |
id | number | Unique product identifier used when placing orders. |
name | string | Product name. |
minFaceValue | number | Minimum face value available for the product. |
maxFaceValue | number | Maximum face value available for the product. |
count | number | null | Available quantity. Null means unrestricted; 0 means out of stock. |
price.min | number | Minimum client price mapped to the face value range. |
price.max | number | Maximum client price mapped to the face value range. |
price.currencyCode | string | Currency code used for the product price. |
modifiedDate | string | Last catalog update timestamp for the product. |
Version comparison
Bamboo provides two catalog versions. Both are supported and actively used.
v2.0
Version v2.0
Supports filtering by currency, country, name, product ID, and brand ID. Also supports pagination and target-currency display.
On this page
Try it out
Open the interactive API panel to test this endpoint with your own credentials.