curl --request PATCH \
--url https://api.global.direct.reap.global/2026-11-05/cards/activities/{activityId} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"note": "<string>",
"categoryId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'const options = {
method: 'PATCH',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({note: '<string>', categoryId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};
fetch('https://api.global.direct.reap.global/2026-11-05/cards/activities/{activityId}', 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-05/cards/activities/{activityId}"
payload = {
"note": "<string>",
"categoryId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"id": "txn_00000000-0000-0000-0000-00000000f001",
"chargeId": "tid_0uWewrFOTL",
"type": "CHARGE",
"status": "CLEARED",
"declineReason": null,
"createdAt": "2026-07-13T08:00:00.000Z",
"clearedAt": "2026-07-14T08:00:00.000Z",
"isCredit": false,
"billAmount": {
"amount": "100.00",
"currency": "USD"
},
"transactionAmount": {
"amount": "100.00",
"currency": "USD"
},
"conversionRate": "1",
"merchant": "Example merchant",
"card": {
"id": "3db05d6f-97a9-4c06-a578-087b14b4f859",
"title": "Travel card",
"last4": "4242"
},
"category": {
"id": "d022bf27-0f9c-457a-a06f-d8e301f6944b",
"name": "Travel"
},
"note": "Campaign 4471 – Meta ads, PO-20431",
"hasReceipt": false
}Update card account activity
Required API-key scope: card_activities:write.
Changes the note, the transaction category, or both on a card transaction. Fields you leave out don’t change.
| To | Send |
|---|---|
| Set or change the note | { "note": "PO-1042" } |
| Clear the note | { "note": null } |
| Change the category | { "categoryId": "<category id>" } |
| Change both | { "note": "PO-1042", "categoryId": "<category id>" } |
- Only card transactions (
type: CHARGE) can be updated, including refunds. - Sending the same values again returns
200and changes nothing, so retries are safe. card_activities:writedoesn’t include read access. Listing activities and categories needs their own scopes.
| Error | When |
|---|---|
ACTIVITY_NO_CHARGE | The activity isn’t a card transaction. |
ACTIVITY_CARD_TERMINATED | The card is terminated. |
TRANSACTION_CATEGORY_NOT_FOUND | categoryId isn’t a transaction category in this environment. |
CATEGORY_NOT_APPLIED | The category wasn’t saved. A note sent with it may be saved, so list the activity to check. |
NOTE_NOT_APPLIED | The note wasn’t saved. A category sent with it may be saved, so list the activity to check. |
404 | The activity doesn’t exist or is voided. |
See Activities.
curl --request PATCH \
--url https://api.global.direct.reap.global/2026-11-05/cards/activities/{activityId} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"note": "<string>",
"categoryId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'const options = {
method: 'PATCH',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({note: '<string>', categoryId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};
fetch('https://api.global.direct.reap.global/2026-11-05/cards/activities/{activityId}', 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-05/cards/activities/{activityId}"
payload = {
"note": "<string>",
"categoryId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"id": "txn_00000000-0000-0000-0000-00000000f001",
"chargeId": "tid_0uWewrFOTL",
"type": "CHARGE",
"status": "CLEARED",
"declineReason": null,
"createdAt": "2026-07-13T08:00:00.000Z",
"clearedAt": "2026-07-14T08:00:00.000Z",
"isCredit": false,
"billAmount": {
"amount": "100.00",
"currency": "USD"
},
"transactionAmount": {
"amount": "100.00",
"currency": "USD"
},
"conversionRate": "1",
"merchant": "Example merchant",
"card": {
"id": "3db05d6f-97a9-4c06-a578-087b14b4f859",
"title": "Travel card",
"last4": "4242"
},
"category": {
"id": "d022bf27-0f9c-457a-a06f-d8e301f6944b",
"name": "Travel"
},
"note": "Campaign 4471 – Meta ads, PO-20431",
"hasReceipt": false
}Path Parameters
The activity's id, as returned by List card account activities.
1 - 255Body
An id from List transaction categories. IDs differ between environments. You can't clear a category.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Response
What kind of activity this is: CHARGE (a card transaction), REPAYMENT (a repayment of your card balance), ADJUSTMENT (a correction made by Reap), REBATE (a rebate credited to your card account) or INTEREST (interest charged on an unpaid balance).
CHARGE, REPAYMENT, ADJUSTMENT, REBATE, INTEREST Where a card transaction is in its lifecycle: PENDING (authorised, not yet settled by the merchant), CLEARED (settled), DECLINED (not approved) or VOIDED (cancelled before settling). Null for other activity types.
PENDING, CLEARED, DECLINED, VOIDED, null When the activity happened, in UTC.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$When a card transaction settled, in UTC. Null while it's still pending, or if it never settles.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$A free-text note your team added to the card transaction in the dashboard or through Update card account activity. Null if there is none.