× Freshbooks App Logo
FreshBooks
Official App
Free - Google Play
Get it

Other Income

General Info

Other Income is for recording income that doesn't require an invoice and is received through other means.

This non-invoice income can be from selling through online stores (like Shopify and Etsy), at fairs, selling ads, or renting space, for example.

Requires Authorization

Includes

There are no includes for other income.

Filters

Filter Type Field Description
Equals incomeid matches incomeid exactly
Equals category_name matches category exactly
Equals vis_state matches vis_state exactly

 

Field Descriptions 

Field Type Description
incomeid string unique identifier of this other income entry within the business
amount object subfields: amount and code
amount string amount of the income, to two decimal places
code string three-letter currency code
category_name string Options include: advertising, in_person_sales, online_sales, rentals, other
created_at string Time the other income entry was created, YYYY-MM-DD HH:MM:SS format
date boolean The date the income was received, YYYY-MM-DD format
note object notes on the income
payment_type string Optional type of payment made. "Check", "Credit", "Cash", etc.
source string Source of external income. E.g. Shopify, Etsy, Farmers' Market
taxes object array subfields: amount and name
amount string amount of the tax, to two decimal places
name string name of the tax
updated_at datetime Time the other income entry was last updated, YYYY-MM-DD HH:MM:SS format
vis_state int 0 for active,1 for deleted,2 for archived(more info on vis_state)

Get Single Other Income

Request: GET https://api.freshbooks.com/accounting/account/<accountid>/other_incomes/other_incomes/<incomeid>

Response:

{
   "response": {
      "result": {
         "other_income": { 
                "amount": {
                     "amount": "25.00",
                     "code": "USD"
                },
                 "category_name": "online_sales",
                 "created_at": "2020-09-25 10:53:22",
                 "date": "2020-09-25",
                 "income": 1234,
                 "note": "Cool beans!",
                 "payment_type": "PayPal",
                 "source": "Etsy",
                 "taxes": [
                    {
                       "amount": "3",                                    
                       "name": "HST"
                    },
                    {
                       "amount": "10",
                       "name": "Empire Tax"
                    }
                 ],
                 "updated_at": "2020-09-25 10:53:22",
                 "vis_state": 0
         }
      }
   }
}

List Other Income Entries

Request: GET https://api.freshbooks.com/accounting/account/<accountid>/other_incomes/other_incomes/

Response:

{
   "response": {
      "result": {
         "other_income": { 
                "amount": {
                     "amount": "25.00",
                     "code": "USD"
                },
                 "category_name": "online_sales",
                 "created_at": "2020-09-25 10:53:22",
                 "date": "2020-09-25",
                 "incomeid": 1234,
                 "note": "Cool beans!",
                 "payment_type": "PayPal",
                 "source": "Etsy",
                 "taxes": [
                    {
                       "amount": "3",
                       "name": "HST"
                    },
                    {
                       "amount": "10",
                       "name": "Empire Tax"
                    }
                 ],
                 "updated_at": "2020-09-25 10:53:22",
                 "vis_state": 0
         },{...}
      }
   }
}

Create Single Other Income

Request: POST https://api.freshbooks.com/accounting/account/<accountid>/other_incomes/other_incomes

{
   "other_income": {
      "amount": {
         "amount": "113.00", 
         "code": "USD"
      },
      "category_name": "online_sales",      
      "date": "2020-09-24",
      "note": "Product sent via ground mail",
      "payment_type": "Visa",
      "source": "etsy",
      "taxes": [
        {
         "amount": "3",
         "name": "HST"
        }
      ]
   }
}

Response:

{
   "response": {
      "result": {
         "other_income": { 
                "amount": {
                     "amount": "113.00",
                     "code": "USD"
                },
                 "category_name": "online_sales",
                 "created_at": "2020-09-25 10:53:22",
                 "date": "2020-09-25",
                 "income": 1234,
                 "note": "Cool beans!",
                 "payment_type": "PayPal",
                 "source": "Etsy",
                 "taxes": [
                    {
                       "amount": "3",
                       "name": "HST"
                    }
                 ],
                 "updated_at": "2020-09-25 10:53:22",
                 "vis_state": 0
         }
      }
   }
}

Update Single Other Income Entry

Request: POST https://api.freshbooks.com/accounting/account/<accountid>/other_incomes/other_incomes

{
   "other_income": {
      "amount": {
         "amount": "125.00", 
         "code": "USD"
      },
      "date": "2020-09-25",
      "source": "Squarespace",
   }
}

Response:

{
   "response": {
      "result": {
         "other_income": { 
                "amount": {
                     "amount": "125.00",
                     "code": "USD"
                },
                 "category_name": "online_sales",
                 "created_at": "2020-09-25 10:53:22",
                 "date": "2020-09-24",
                 "income": 1234,
                 "note": "Cool beans!",
                 "payment_type": "PayPal",
                 "source": "Squarespace",
                 "taxes": [
                    {
                       "amount": "3",
                       "name": "HST"
                    }
                 ],
                 "updated_at": "2020-09-25 10:53:22",
                 "vis_state": 0
         }
      }
   }
}

Delete Other Income Entry

Request: DELETE https://api.freshbooks.com/accounting/account/<accountid>/other_incomes/other_incomes

Response:

{
   "response": {}
}