Walletguide
DevelopersAPIReferencecategories

Retrieve category

Retrieve one category by id with the Walletguide REST API. Parameters, response fields, and a playground you can run.

GET
/wallets/{walletId}/categories/{id}

Authorization

bearerAuth
headerAuthorization<token>

A Walletguide API key (wg_…) or an OAuth bearer token. Paste the value only. Create a key under Wallet settings → API keys.

Path Parameters

walletId*string

Row uuid

Formatuuid
id*string

Row uuid

Formatuuid

Response Body

The category

application/json
  1. response
id*string
Formatuuid
walletId*string
Formatuuid
firestoreId*string|null
name*string
type*string
Value in"activeIncome""passiveIncome""gainsLosses""fixedExpenses""variableExpenses""neutral"
emoji*string|null
system*boolean
systemKey*string|null
order*|
Range-140737488355328 <= value <= 140737488355327
categoryGroupId*|
Formatuuid
createdTime*|
Formatdate-time
createdUserId*string|null
lastUpdatedTime*|
Formatdate-time
lastUpdatedUserId*string|null
curl -X GET "https://example.com/wallets/497f6eca-6276-4993-bfeb-53cbbbba6f08/categories/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "walletId": "0ecad4a2-3549-43fb-807e-9ff033247480",  "firestoreId": "string",  "name": "string",  "type": "activeIncome",  "emoji": "string",  "system": true,  "systemKey": "string",  "order": -140737488355328,  "categoryGroupId": "94a69c98-7014-42e1-a3ec-9154712b315b",  "createdTime": "2019-08-24T14:15:22Z",  "createdUserId": "string",  "lastUpdatedTime": "2019-08-24T14:15:22Z",  "lastUpdatedUserId": "string"}

Merge

Creates the merged tag, moves every transaction reference from the old tags to it, and deletes the old tags — one transaction (legacy mergeTags).

Update category

Update a category with the Walletguide REST API. Parameters, response fields, and a playground you can run.