Account balances
Clean account cards with balance, currency, role and last update.
A compact, read-only account overview from Firefly III's official v1 API. It deliberately avoids transaction arrays in v1 of this package, so every card has a stable account-level grain.
Prepare Firefly III:
1. Open your user profile and create a Personal Access Token for API use.
2. Keep the token private and revoke it from Firefly III when it is no longer needed.
3. The official OpenAPI describes GET /api/v1/accounts and supports Bearer authentication.
Official API specification: https://github.com/firefly-iii/api-docs
Configure Cifru on iPhone/iPad:
1. Sources → Add source → REST JSON. Base URL: your Firefly III HTTPS address followed by /api/v1.
2. Select Bearer token authentication and paste the Personal Access Token.
3. Test GET /accounts before importing, then map the single REST slot.
4. Run the package read test and confirm that the JSON row path is data.
5. The package contains no server address, account data or token.
What this package creates
1 Home0 Details1 lists1 sources to map
- Home: Account balances
Sources are mapped locally and verified before applying.
View the JSON being importedcollapsed by default
{
"components": {
"sourceSlots": [
{
"displayName": "Firefly III REST",
"id": "C9C24D45-968A-5820-BCFE-E360A25D8BF0",
"kind": "rest",
"requiredObjects": [
"/api/v1/accounts"
],
"requiresCustomSQL": false
}
],
"workspaceSelection": {
"commonFields": [],
"datasets": [
{
"cacheMode": "cached",
"calculatedFields": [],
"customQueryIntegrationName": "",
"endpointPath": "accounts?limit=100",
"fetchSortRules": [],
"id": "E84FF5D7-3FA8-5524-B0DF-C43C79410198",
"mappings": [
{
"commonFieldKey": "",
"key": "id",
"label": "Account ID",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic",
"sourceColumn": "id",
"type": "text",
"visibleInDetail": true,
"visibleInList": false
},
{
"commonFieldKey": "",
"key": "attributes.name",
"label": "Account",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic",
"sourceColumn": "attributes.name",
"type": "text",
"visibleInDetail": true,
"visibleInList": true
},
{
"commonFieldKey": "",
"key": "attributes.type",
"label": "Type",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic",
"sourceColumn": "attributes.type",
"type": "text",
"visibleInDetail": true,
"visibleInList": true
},
{
"commonFieldKey": "",
"key": "attributes.account_role",
"label": "Role",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic",
"sourceColumn": "attributes.account_role",
"type": "text",
"visibleInDetail": true,
"visibleInList": true
},
{
"commonFieldKey": "",
"key": "attributes.current_balance",
"label": "Current balance",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic",
"sourceColumn": "attributes.current_balance",
"type": "number",
"visibleInDetail": true,
"visibleInList": true
},
{
"commonFieldKey": "",
"key": "attributes.currency_code",
"label": "Currency",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic",
"sourceColumn": "attributes.currency_code",
"type": "text",
"visibleInDetail": true,
"visibleInList": true
},
{
"commonFieldKey": "",
"key": "attributes.active",
"label": "Active",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic",
"sourceColumn": "attributes.active",
"type": "boolean",
"visibleInDetail": true,
"visibleInList": true
},
{
"commonFieldKey": "",
"key": "attributes.updated_at",
"label": "Updated",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic",
"sourceColumn": "attributes.updated_at",
"type": "date",
"visibleInDetail": true,
"visibleInList": true
}
],
"maxRows": 100,
"name": "Account balances",
"primaryKey": "id",
"refreshPolicy": {
"enabled": true,
"intervalMinutes": 15
},
"rootArrayPath": "data",
"rowLimitEnabled": true,
"searchKeys": [
"id",
"attributes.name",
"attributes.type",
"attributes.account_role",
"attributes.current_balance"
],
"sourceID": "C9C24D45-968A-5820-BCFE-E360A25D8BF0",
"sqlQuery": "",
"tableName": ""
}
],
"pages": [
{
"actions": [],
"badgeKey": "attributes.current_balance",
"cardEnrichments": [],
"cardFieldLayout": [
{
"detailGroup": "",
"detailRole": "information",
"isVisible": true,
"key": "attributes.name",
"label": "Account",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic"
},
{
"detailGroup": "",
"detailRole": "information",
"isVisible": true,
"key": "attributes.type",
"label": "Type",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic"
},
{
"detailGroup": "",
"detailRole": "information",
"isVisible": true,
"key": "attributes.current_balance",
"label": "Current balance",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic"
},
{
"detailGroup": "",
"detailRole": "information",
"isVisible": true,
"key": "attributes.currency_code",
"label": "Currency",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic"
},
{
"detailGroup": "",
"detailRole": "information",
"isVisible": true,
"key": "attributes.account_role",
"label": "Role",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic"
},
{
"detailGroup": "",
"detailRole": "information",
"isVisible": true,
"key": "attributes.updated_at",
"label": "Updated",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic"
}
],
"datasetID": "E84FF5D7-3FA8-5524-B0DF-C43C79410198",
"dateFilterKey": "",
"dateFilterLastDays": 7,
"dateFilterPreset": "none",
"detailFieldLayout": [
{
"detailGroup": "",
"detailRole": "information",
"isVisible": true,
"key": "id",
"label": "Account ID",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic"
},
{
"detailGroup": "",
"detailRole": "information",
"isVisible": true,
"key": "attributes.name",
"label": "Account",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic"
},
{
"detailGroup": "",
"detailRole": "information",
"isVisible": true,
"key": "attributes.type",
"label": "Type",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic"
},
{
"detailGroup": "",
"detailRole": "information",
"isVisible": true,
"key": "attributes.account_role",
"label": "Role",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic"
},
{
"detailGroup": "",
"detailRole": "highlight",
"isVisible": true,
"key": "attributes.current_balance",
"label": "Current balance",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic"
},
{
"detailGroup": "",
"detailRole": "information",
"isVisible": true,
"key": "attributes.currency_code",
"label": "Currency",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic"
},
{
"detailGroup": "",
"detailRole": "information",
"isVisible": true,
"key": "attributes.active",
"label": "Active",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic"
},
{
"detailGroup": "",
"detailRole": "information",
"isVisible": true,
"key": "attributes.updated_at",
"label": "Updated",
"locationLabelKey": "",
"locationLongitudeKey": "",
"presentation": "automatic"
}
],
"fixedFilters": [],
"id": "0B6F9609-6349-54EB-A4AC-002F2C9D74DF",
"openFilters": [],
"pageSize": 100,
"requiresOpeningFilterSelection": false,
"showOnHome": true,
"sortRules": [],
"subtitle": "",
"subtitleKey": "attributes.type",
"systemImage": "banknote",
"title": "Account balances",
"titleKey": "attributes.name"
}
],
"relations": [],
"widgets": []
}
},
"format": "cifru-configuration-package",
"formatVersion": 1,
"manifest": {
"applicationName": "Firefly III",
"configurationLanguages": [
"en"
],
"countries": [
"ALL"
],
"createdAt": "2026-07-24T16:26:43Z",
"description": "A compact, read-only account overview from Firefly III's official v1 API. It deliberately avoids transaction arrays in v1 of this package, so every card has a stable account-level grain.\n\nPrepare Firefly III:\n1. Open your user profile and create a Personal Access Token for API use.\n2. Keep the token private and revoke it from Firefly III when it is no longer needed.\n3. The official OpenAPI describes GET /api/v1/accounts and supports Bearer authentication.\nOfficial API specification: https://github.com/firefly-iii/api-docs\n\nConfigure Cifru on iPhone/iPad:\n1. Sources → Add source → REST JSON. Base URL: your Firefly III HTTPS address followed by /api/v1.\n2. Select Bearer token authentication and paste the Personal Access Token.\n3. Test GET /accounts before importing, then map the single REST slot.\n4. Run the package read test and confirm that the JSON row path is data.\n5. The package contains no server address, account data or token.",
"licenseCode": "Cifru-Community-1.0",
"minimumCifruVersion": "1.0",
"minimumPlan": "free",
"packageID": "9EBDFBC8-11E4-56F8-97E3-4A3C77834CCA",
"rootButtonCount": 1,
"summary": "Clean account cards with balance, currency, role and last update.",
"tags": [
"Firefly III",
"finance",
"accounts",
"REST"
],
"title": "Account balances"
}
}