Grouped by client
The response is grouped by client, then by transactions for that client.
GET
Transactions
Retrieve account transaction history for a selected date range, including order totals, balances, product details, and exchange-rate information.
GET
/api/Integration/v1/transactionsTransactions returns balance movement data for the authenticated client over a specified date range.
Use this endpoint for reconciliation, balance tracking, order-level financial review, and product-level transaction analysis.
This endpoint requires Basic Auth using your API credentials.
Query parameters
Provide the reporting dates you want Bamboo to search.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
startDate | string | Yes | Start date for the report. | 2022-10-01 |
endDate | string | Yes | End date for the report. | 2022-11-20 |
Response specifications
The transaction report is grouped by client, then by transaction entries, and then by order-item detail.
| Field | Type | Description |
|---|---|---|
startDate | string | Start date used for the transaction query. |
endDate | string | End date used for the transaction query. |
clients | array | Clients included in the response. |
clientName | string | Client name. |
transactions | array | Transaction records for the client. |
orderId | number | Internal order identifier. |
requestId | string | Client request id used when placing the order. |
productId | number | Product id linked to the transaction. |
orderNumber | string | Bamboo order number. |
orderTotal | object | Total order amount and currency. |
orderTotalForSelectedProducts | object | Total for the products selected in the transaction row. |
currencyCode | string | null | Transaction currency code when provided. |
orderDate | string | Order date timestamp. |
transactionId | string | Unique transaction identifier. |
transactionType | string | Transaction type, for example Order. |
comment | string | null | Optional Bamboo comment. |
notes | string | null | Optional Bamboo notes. |
availableBalance | object | Balance available after the transaction. |
transactionAmount | object | Amount deducted or added by the transaction. |
transactionDate | string | Date and time of the transaction. |
orderItems | array | Product-level transaction details. |
productName | string | Product name. |
brandName | string | Brand name. |
denomination | object | Requested denomination value and currency. |
clientPrice | object | Client price for the order item. |
estimatedPrice | object | Estimated Bamboo price for the order item. |
quantity | number | Quantity purchased for the product. |
clientTotal | number | Total charged for the order item. |
clientExchangeRate | object | Applied exchange-rate information for the item. |
xeroCreditNoteNumber | string | null | Optional external credit note number. |
Examples
Full request and response examples for this endpoint.
Example request
Use this full request as the primary reference for client-side implementation.
# Generate token: echo -n 'YOUR_CLIENT_ID:YOUR_CLIENT_SECRET' | base64
curl --location 'https://api.bamboocardportal.com/api/Integration/v1/transactions?startDate=2026-04-01&endDate=2026-05-19' \
--header 'Authorization: Basic YOUR_BASE64_TOKEN' \
--header 'Accept: application/json'Example response
Use this sample payload to validate parsing, field mapping, and downstream handling.
200 OK
{
"startDate": "2024-05-15T00:00:00",
"endDate": "2024-05-16T23:59:59",
"clients": [
{
"clientName": "Bamboo Tech - Testing",
"transactions": [
{
"orderId": 6761537,
"requestId": "97018cf7-98f5-40fc-a142-711d43a72e17",
"productId": 439685,
"orderNumber": "O-06761537",
"orderTotal": {
"value": 9.47,
"currencyCode": "USD"
},
"orderTotalForSelectedProducts": {
"value": 9.47,
"currencyCode": "USD"
},
"currencyCode": null,
"orderDate": "2024-05-15T04:29:41.3062431",
"transactionId": "6677709",
"transactionType": "Order",
"comment": null,
"notes": null,
"availableBalance": {
"value": 100828.4848,
"currencyCode": "USD"
},
"transactionAmount": {
"value": 9.47,
"currencyCode": "USD"
},
"transactionDate": "2024-05-15T04:29:41.3062431",
"orderItems": [
{
"createdDate": "0001-01-01T00:00:00",
"productName": "Steam 10 USD BH",
"brandName": "Steam Bahrain",
"denomination": {
"value": 10,
"currencyCode": "USD"
},
"clientPrice": {
"value": 9.47,
"currencyCode": "USD"
},
"estimatedPrice": {
"value": 9.47,
"currencyCode": "USD"
},
"quantity": 1,
"clientTotal": 9.47,
"clientExchangeRate": {
"fromCurrency": "USD",
"toCurrency": "USD",
"exchangeRate": 0
}
}
],
"xeroCreditNoteNumber": null
}
]
}
]
}Transaction report guidance
These report behaviors matter when you reconcile Bamboo activity with your own financial systems.
Balance after each movement
availableBalance shows the account balance after the transaction was applied.
Selected-product totals
orderTotalForSelectedProducts isolates the total for the selected products represented in the transaction row.
Cross-currency context
clientExchangeRate explains how Bamboo priced the order item when the brand currency differs from the charged account currency.
Operational notes
Use the transaction report as a financial data source rather than a fulfillment data source.
Date range selection
Choose a date range that contains the transaction activity you want Bamboo to return.
Order item detail
orderItems contains product name, denomination, quantity, price, and exchange-rate detail for the transaction.
Nullable fields
comment, notes, currencyCode, and xeroCreditNoteNumber can be null depending on the transaction record.
On this page
Try it out
Open the interactive API panel to test this endpoint with your own credentials.