{"id":16374451,"url":"https://github.com/azz/up-api-google-sheets","last_synced_at":"2025-10-26T08:30:40.908Z","repository":{"id":66082010,"uuid":"297995983","full_name":"azz/up-api-google-sheets","owner":"azz","description":"Prototype for using the Up Banking API in Google Sheets","archived":false,"fork":false,"pushed_at":"2024-03-27T22:54:07.000Z","size":133,"stargazers_count":5,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-31T17:11:34.776Z","etag":null,"topics":["google-sheets","hacktoberfest","up-api","up-banking"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/azz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2020-09-23T14:26:30.000Z","updated_at":"2024-08-04T03:46:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"ca00aa25-6dfc-4317-afff-e093c904f3fd","html_url":"https://github.com/azz/up-api-google-sheets","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azz%2Fup-api-google-sheets","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azz%2Fup-api-google-sheets/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azz%2Fup-api-google-sheets/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azz%2Fup-api-google-sheets/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/azz","download_url":"https://codeload.github.com/azz/up-api-google-sheets/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238293229,"owners_count":19448146,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["google-sheets","hacktoberfest","up-api","up-banking"],"created_at":"2024-10-11T03:17:16.975Z","updated_at":"2025-10-26T08:30:35.617Z","avatar_url":"https://github.com/azz.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# up-api-google-sheets\n\nPrototype for using the [Up Banking API](https://developer.up.com.au/) in Google Sheets.\n\n\u003e **NOTE:** The Up API is in beta release for personal use only.\n\n## Installation\n\n1. Create a new Google Sheet and select \"Extensions\" → \"Apps Script\".\n2. Paste in the contents of [`up.js`](https://github.com/azz/up-api-google-sheets/blob/master/up.js) into the code window.\n3. Save the script, and rename the project to \"Up API\" and accept the authorization request (you may need to proceed through a security warning, as this is not a published Addon).\n4. Click the \"Run\" button with the \"onOpen\" function selected.\n5. Go back to your Google Sheet and you should have a new \"Up API\" drop-down. Select\"Up API\" → \"Set Up...\".\n\n## Usage\n\nOnce you have authenticated (\"Up API\" → \"Set Up...\"), you will be able to insert formulas.\n\nAll the formulas provided by this script can be inserted from the \"Up API\" menu. Doing so will insert the formula, apply some styling, then auto-size the columns. Alternatively, you can enter in the formulas manually.\n\nYou can share a sheet with someone else and they will have to use their own personal access token. None of your data will be shared.\n\nYour token will only be stored for one day. After this time your data will be cleared and you will have to re-authenticate.\n\n## Functions\n\n\u003cdl\u003e\n\u003cdt\u003e\u003ca href=\"#UP_TRANSACTIONS\"\u003eUP_TRANSACTIONS(yeah, filterQuery, type)\u003c/a\u003e \u003c/dt\u003e\n\u003cdd\u003e\u003cp\u003eRetrieve transactions across all of your Up accounts.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003ca href=\"#UP_TRANSACTIONS_BETWEEN\"\u003eUP_TRANSACTIONS_BETWEEN(yeah, since, until, filterQuery, type)\u003c/a\u003e \u003c/dt\u003e\n\u003cdd\u003e\u003cp\u003eRetrieve all transactions between two dates.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003ca href=\"#UP_TRANSACTIONS_FOR_ACCOUNT\"\u003eUP_TRANSACTIONS_FOR_ACCOUNT(yeah, accountId, filterQuery, type)\u003c/a\u003e \u003c/dt\u003e\n\u003cdd\u003e\u003cp\u003eRetrieve transactions from a specific Up account.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003ca href=\"#UP_ACCOUNTS\"\u003eUP_ACCOUNTS(yeah)\u003c/a\u003e \u003c/dt\u003e\n\u003cdd\u003e\u003cp\u003eRetrieve all your Up accounts, including balances.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003ca href=\"#UP_CATEGORIES\"\u003eUP_CATEGORIES(yeah)\u003c/a\u003e \u003c/dt\u003e\n\u003cdd\u003e\u003cp\u003eRetrieve all Up pre-defined categories, including parent categories.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003ca href=\"#UP_TAGS\"\u003eUP_TAGS(yeah)\u003c/a\u003e \u003c/dt\u003e\n\u003cdd\u003e\u003cp\u003eRetrieve all your user-defined tags.\u003c/p\u003e\n\u003c/dd\u003e\n\u003cdt\u003e\u003ca href=\"#UP_PING\"\u003eUP_PING(yeah)\u003c/a\u003e \u003c/dt\u003e\n\u003cdd\u003e\u003cp\u003ePing the Up API to validate your token.\u003c/p\u003e\n\u003c/dd\u003e\n\u003c/dl\u003e\n\n\u003ca name=\"UP_TRANSACTIONS\"\u003e\u003c/a\u003e\n\n## UP_TRANSACTIONS(yeah, filterQuery, type)\n\nRetrieve transactions across all of your Up accounts.\n\n**Kind**: global function  \n**Returns**: Up Transactions  \n**Customfunction**:\n\n| Param       | Type                                                              | Default       | Description                                                                         |\n| ----------- | ----------------------------------------------------------------- | ------------- | ----------------------------------------------------------------------------------- |\n| yeah        |                                                                   |               | Dependencies.                                                                       |\n| filterQuery | \u003ccode\u003estring\u003c/code\u003e                                               |               | The filter querystring to use, e.g. `\"filter[status]=HELD\u0026filter[category]=booze\"`. |\n| type        | \u003ccode\u003e\u0026quot;DEBIT\u0026quot;\u003c/code\u003e \\| \u003ccode\u003e\u0026quot;CREDIT\u0026quot;\u003c/code\u003e | \u003ccode\u003e\u003c/code\u003e | Further filter transactions by direction (ALL/CREDIT/DEBIT).                        |\n\n**Example**\n\n```js\n=UP_TRANSACTIONS(Yeah, \"filter[category]=takeaway\", \"DEBIT\") // All outgoing transactions classified as \"takeaway\".\n```\n\n\u003ca name=\"UP_TRANSACTIONS_BETWEEN\"\u003e\u003c/a\u003e\n\n## UP_TRANSACTIONS_BETWEEN(yeah, since, until, filterQuery, type)\n\nRetrieve all transactions between two dates.\n\n**Kind**: global function  \n**Returns**: Up Transactions  \n**Customfunction**:\n\n| Param       | Type                                                              | Default       | Description                                                                         |\n| ----------- | ----------------------------------------------------------------- | ------------- | ----------------------------------------------------------------------------------- |\n| yeah        |                                                                   |               | Dependencies.                                                                       |\n| since       | \u003ccode\u003eDate\u003c/code\u003e                                                 |               | The start date.                                                                     |\n| until       | \u003ccode\u003eDate\u003c/code\u003e                                                 |               | The end date.                                                                       |\n| filterQuery | \u003ccode\u003estring\u003c/code\u003e                                               |               | The filter querystring to use, e.g. `\"filter[status]=HELD\u0026filter[category]=booze\"`. |\n| type        | \u003ccode\u003e\u0026quot;DEBIT\u0026quot;\u003c/code\u003e \\| \u003ccode\u003e\u0026quot;CREDIT\u0026quot;\u003c/code\u003e | \u003ccode\u003e\u003c/code\u003e | Further filter transactions by direction (ALL/CREDIT/DEBIT).                        |\n\n**Example**\n\n```js\n=UP_TRANSACTIONS_BETWEEN(Yeah, TODAY() - 7, TODAY()) // All transactions in the last week.\n```\n\n**Example**\n\n```js\n=UP_TRANSACTIONS_BETWEEN(Yeah, A1, B1) // All transactions between the dates set in cells `A1` and `B1`.\n```\n\n\u003ca name=\"UP_TRANSACTIONS_FOR_ACCOUNT\"\u003e\u003c/a\u003e\n\n## UP_TRANSACTIONS_FOR_ACCOUNT(yeah, accountId, filterQuery, type)\n\nRetrieve transactions from a specific Up account.\n\n**Kind**: global function  \n**Returns**: Up Transactions  \n**Customfunction**:\n\n| Param       | Type                                                              | Default       | Description                                                                         |\n| ----------- | ----------------------------------------------------------------- | ------------- | ----------------------------------------------------------------------------------- |\n| yeah        |                                                                   |               | Dependencies.                                                                       |\n| accountId   | \u003ccode\u003estring\u003c/code\u003e                                               |               | The Up Account ID.                                                                  |\n| filterQuery | \u003ccode\u003estring\u003c/code\u003e                                               |               | The filter querystring to use, e.g. `\"filter[status]=HELD\u0026filter[category]=booze\"`. |\n| type        | \u003ccode\u003e\u0026quot;DEBIT\u0026quot;\u003c/code\u003e \\| \u003ccode\u003e\u0026quot;CREDIT\u0026quot;\u003c/code\u003e | \u003ccode\u003e\u003c/code\u003e | Further filter transactions by direction (ALL/CREDIT/DEBIT).                        |\n\n**Example**\n\n```js\n=UP_TRANSACTIONS_FOR_ACCOUNT(Yeah, \"aaaa-bbbb-cccc-dddd-eee\") // All transactions for the specified account.\n```\n\n\u003ca name=\"UP_ACCOUNTS\"\u003e\u003c/a\u003e\n\n## UP_ACCOUNTS(yeah)\n\nRetrieve all your Up accounts, including balances.\n\n**Kind**: global function  \n**Returns**: Up Accounts  \n**Customfunction**:\n\n| Param | Description   |\n| ----- | ------------- |\n| yeah  | Dependencies. |\n\n**Example**\n\n```js\n=UP_ACCOUNTS(Yeah) // Get all accounts.\n```\n\n\u003ca name=\"UP_CATEGORIES\"\u003e\u003c/a\u003e\n\n## UP_CATEGORIES(yeah)\n\nRetrieve all Up pre-defined categories, including parent categories.\n\n**Kind**: global function  \n**Returns**: Up Categories  \n**Customfunction**:\n\n| Param | Description   |\n| ----- | ------------- |\n| yeah  | Dependencies. |\n\n**Example**\n\n```js\n=UP_CATEGORIES(Yeah) // Get all categories.\n```\n\n\u003ca name=\"UP_TAGS\"\u003e\u003c/a\u003e\n\n## UP_TAGS(yeah)\n\nRetrieve all your user-defined tags.\n\n**Kind**: global function  \n**Returns**: Up Tags  \n**Customfunction**:\n\n| Param | Description   |\n| ----- | ------------- |\n| yeah  | Dependencies. |\n\n**Example**\n\n```js\n=UP_TAGS(Yeah) // Get all tags.\n```\n\n\u003ca name=\"UP_PING\"\u003e\u003c/a\u003e\n\n## UP_PING(yeah)\n\nPing the Up API to validate your token.\n\n**Kind**: global function  \n**Returns**: Up Ping  \n**Customfunction**:  \n**Example**\n\n```js\n=UP_PING(Yeah) // Ping the API.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazz%2Fup-api-google-sheets","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazz%2Fup-api-google-sheets","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazz%2Fup-api-google-sheets/lists"}