List transaction categories
curl --request GET \
--url https://api.global.direct.reap.global/2026-11-16/cards/transaction-categories \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.global.direct.reap.global/2026-11-16/cards/transaction-categories', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.global.direct.reap.global/2026-11-16/cards/transaction-categories"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"id": "4ef5a2c4-b2e4-4b63-900c-f60819a78674",
"name": "Software & SaaS",
"code": "software_and_saas"
},
{
"id": "fbdc675f-5391-430d-9058-b6f0684f9060",
"name": "Flights",
"code": "flights"
},
{
"id": "64b533dd-f96e-4e1e-9863-1ff18839e6cf",
"name": "Other",
"code": "other"
}
]
}Categories
List transaction categories
Required API-key scope: card_activities:read.
Returns the transaction categories Reap uses to classify card transactions, such as Flights or Software.
other and on_off_ramp_fees are in this list, but you can’t use them in restriction.category. Sending either to Update card usage restriction returns CATEGORY_NOT_FOUND.
Reap maps each card transaction to a category automatically, using the merchant data from the card network. You can change it with Update card account activity, or your team can correct it in the dashboard.
- Use the
codevalues to limit a card with Update card usage restriction. - Use the
idvalues to filter List card account activities bycategoryId.
See Activities.
GET
/
2026-11-16
/
cards
/
transaction-categories
List transaction categories
curl --request GET \
--url https://api.global.direct.reap.global/2026-11-16/cards/transaction-categories \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.global.direct.reap.global/2026-11-16/cards/transaction-categories', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.global.direct.reap.global/2026-11-16/cards/transaction-categories"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"id": "4ef5a2c4-b2e4-4b63-900c-f60819a78674",
"name": "Software & SaaS",
"code": "software_and_saas"
},
{
"id": "fbdc675f-5391-430d-9058-b6f0684f9060",
"name": "Flights",
"code": "flights"
},
{
"id": "64b533dd-f96e-4e1e-9863-1ff18839e6cf",
"name": "Other",
"code": "other"
}
]
}This page is for API version
2026-11-16, where the endpoint needs the card_activities:read scope. On 2026-07-13 and 2026-11-05 it needs cards:read.
Change a transaction’s category with Update card account activity, or your team can correct it in the dashboard. See Reviewing and Categorizing Transactions in the Help Center.