List available categories
Returns the standard categories the company can still add with POST /categories, in a fixed order, leaving out any the company already has. Each option lists every category it adds, parents first, with its description: what the category is for, the same text GET /categories returns once it’s added (empty when Finta hasn’t described it). Read the descriptions to choose an option that fits what you want to track, not just its name. access says whether you can add it: add with POST /categories, request_required when only Finta adds it, or plan_upgrade_required when the company’s plan doesn’t include it (the codes POST /categories returns). When both refusals apply, it’s plan_upgrade_required, as on POST /categories. Each category also carries accounting_treatment, what Finta books automatically once a transaction is categorized there (today only Equipment’s 5-year depreciation), the same field GET /categories returns; tell the user about it before adding the option. Requires API access and Accounting setup: View.
curl --request GET \
--url https://app.finta.com/api/v1/categories/available \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.finta.com/api/v1/categories/available"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.finta.com/api/v1/categories/available', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.finta.com/api/v1/categories/available",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.finta.com/api/v1/categories/available"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.finta.com/api/v1/categories/available")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.finta.com/api/v1/categories/available")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"object": "list",
"url": "/api/v1/categories/available",
"data": [
{
"object": "available_category",
"key": "fulfillment",
"name": "Fulfillment",
"access": "add",
"categories": [
{
"name": "Fulfillment",
"parent_name": "Cost of Revenue",
"description": "Cost of physical goods shipped to fulfill customer orders, such as packaging and shipping.",
"accounting_treatment": null
}
]
},
{
"object": "available_category",
"key": "rd_expenses",
"name": "R&D Expenses",
"access": "add",
"categories": [
{
"name": "R&D Expenses",
"parent_name": "Expenses",
"description": "",
"accounting_treatment": null
},
{
"name": "Consumables",
"parent_name": "R&D Expenses",
"description": "Lab supplies used up in experiments, such as pipette tips, gloves and culture plates.",
"accounting_treatment": null
},
{
"name": "Biologicals",
"parent_name": "R&D Expenses",
"description": "Biological materials for research, such as cell lines, antibodies and enzymes.",
"accounting_treatment": null
},
{
"name": "Chemicals",
"parent_name": "R&D Expenses",
"description": "Chemical reagents and solvents for lab work.",
"accounting_treatment": null
},
{
"name": "R&D services",
"parent_name": "R&D Expenses",
"description": "Outsourced research, such as CROs and contract labs.",
"accounting_treatment": null
}
]
},
{
"object": "available_category",
"key": "intercompany_expenses",
"name": "Intercompany Expenses",
"access": "request_required",
"categories": [
{
"name": "Intercompany Expenses",
"parent_name": "Expenses",
"description": "Expenses charged between a parent company and its subsidiaries.",
"accounting_treatment": null
}
]
},
{
"object": "available_category",
"key": "equipment",
"name": "Equipment",
"access": "add",
"categories": [
{
"name": "Equipment",
"parent_name": "Assets",
"description": "Computers, furniture, and other physical equipment expected to last more than a year.",
"accounting_treatment": "Depreciated straight-line over 5 years: the purchase is recorded as an asset and expensed monthly as depreciation."
},
{
"name": "Accumulated Depreciation",
"parent_name": "Assets",
"description": "",
"accounting_treatment": null
}
]
}
]
}Authorizations
Was this page helpful?
curl --request GET \
--url https://app.finta.com/api/v1/categories/available \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.finta.com/api/v1/categories/available"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.finta.com/api/v1/categories/available', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.finta.com/api/v1/categories/available",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.finta.com/api/v1/categories/available"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.finta.com/api/v1/categories/available")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.finta.com/api/v1/categories/available")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"object": "list",
"url": "/api/v1/categories/available",
"data": [
{
"object": "available_category",
"key": "fulfillment",
"name": "Fulfillment",
"access": "add",
"categories": [
{
"name": "Fulfillment",
"parent_name": "Cost of Revenue",
"description": "Cost of physical goods shipped to fulfill customer orders, such as packaging and shipping.",
"accounting_treatment": null
}
]
},
{
"object": "available_category",
"key": "rd_expenses",
"name": "R&D Expenses",
"access": "add",
"categories": [
{
"name": "R&D Expenses",
"parent_name": "Expenses",
"description": "",
"accounting_treatment": null
},
{
"name": "Consumables",
"parent_name": "R&D Expenses",
"description": "Lab supplies used up in experiments, such as pipette tips, gloves and culture plates.",
"accounting_treatment": null
},
{
"name": "Biologicals",
"parent_name": "R&D Expenses",
"description": "Biological materials for research, such as cell lines, antibodies and enzymes.",
"accounting_treatment": null
},
{
"name": "Chemicals",
"parent_name": "R&D Expenses",
"description": "Chemical reagents and solvents for lab work.",
"accounting_treatment": null
},
{
"name": "R&D services",
"parent_name": "R&D Expenses",
"description": "Outsourced research, such as CROs and contract labs.",
"accounting_treatment": null
}
]
},
{
"object": "available_category",
"key": "intercompany_expenses",
"name": "Intercompany Expenses",
"access": "request_required",
"categories": [
{
"name": "Intercompany Expenses",
"parent_name": "Expenses",
"description": "Expenses charged between a parent company and its subsidiaries.",
"accounting_treatment": null
}
]
},
{
"object": "available_category",
"key": "equipment",
"name": "Equipment",
"access": "add",
"categories": [
{
"name": "Equipment",
"parent_name": "Assets",
"description": "Computers, furniture, and other physical equipment expected to last more than a year.",
"accounting_treatment": "Depreciated straight-line over 5 years: the purchase is recorded as an asset and expensed monthly as depreciation."
},
{
"name": "Accumulated Depreciation",
"parent_name": "Assets",
"description": "",
"accounting_treatment": null
}
]
}
]
}