Struct up_api::v1::Client

pub struct Client { /* private fields */ }

A client for interacting with the Up API.

Implementations

impl Client

pub async fn list_accounts(
    &self,
    options: &ListAccountsOptions
) -> Result<ListAccountsResponse, Error>

Retrieve a paginated list of all accounts for the currently authenticated user. The returned list is paginated and can be scrolled by following the prev and next links where present.

pub async fn get_account(&self, id: &str) -> Result<GetAccountResponse, Error>

Retrieve a specific account by providing its unique identifier.

impl Client

pub async fn list_categories(
    &self,
    options: &ListCategoriesOptions
) -> Result<ListCategoriesResponse, Error>

Retrieve a list of all categories and their ancestry. The returned list is not paginated.

pub async fn get_category(&self, id: &str) -> Result<GetCategoryResponse, Error>

Retrieve a specific category by providing its unique identifier.

pub async fn categorise_transaction(
    &self,
    transaction_id: &str,
    category: Option<&str>
) -> Result<(), Error>

Updates the category associated with a transaction. Only transactions for which is_categorizable is set to true support this operation. The id is taken from the list exposed on list_categories and cannot be one of the top-level (parent) categories. To de-categorize a transaction, set the entire data key to null. The associated category, along with its request URL is also exposed via the category relationship on the transaction resource returned from get_transaction.

impl Client

pub async fn list_tags(
    &self,
    options: &ListTagsOptions
) -> Result<ListTagsResponse, Error>

Retrieve a list of all tags currently in use. The returned list is paginated and can be scrolled by following the next and prev links where present. Results are ordered lexicographically. The transactions relationship for each tag exposes a link to get the transactions with the given tag.

pub async fn add_tags(
    &self,
    transaction_id: &str,
    tags: Vec<String>
) -> Result<(), Error>

Associates one or more tags with a specific transaction. No more than 6 tags may be present on any single transaction. Duplicate tags are silently ignored. The associated tags, along with this request URL, are also exposed via the tags relationship on the transaction resource returned from get_transaction.

pub async fn delete_tags(
    &self,
    transaction_id: &str,
    tags: Vec<String>
) -> Result<(), Error>

Disassociates one or more tags from a specific transaction. Tags that are not associated are silently ignored. The associated tags, along with this request URL, are also exposed via the tags relationship on the transaction resource returned from get_transaction.

impl Client

pub async fn list_transactions(
    &self,
    options: &ListTransactionsOptions
) -> Result<ListTransactionsResponse, Error>

Retrieve a list of all transactions across all accounts for the currently authenticated user. The returned list is paginated and can be scrolled by following the next and prev links where present. To narrow the results to a specific date range pass one or both of filter[since] and filter[until] in the query string. These filter parameters should not be used for pagination. Results are ordered newest first to oldest last.

pub async fn get_transaction(
    &self,
    id: &String
) -> Result<GetTransactionResponse, Error>

Retrieve a specific transaction by providing its unique identifier.

pub async fn list_transactions_by_account(
    &self,
    account_id: &String,
    options: &ListTransactionsOptions
) -> Result<ListTransactionsResponse, Error>

Retrieve a list of all transactions for a specific account. The returned list is paginated and can be scrolled by following the next and prev links where present. To narrow the results to a specific date range pass one or both of filter[since] and filter[until] in the query string. These filter parameters should not be used for pagination. Results are ordered newest first to oldest last.

impl Client

pub async fn ping(&self) -> Result<PingResponse, Error>

Make a basic ping request to the API. This is useful to verify that authentication is functioning correctly.

impl Client

pub fn new(access_token: String) -> Self

Creates an instance of the Client from the access token. Visit this page to get such a token.