API reference / Expense categories

Expense categories API

5 endpoints. Scopes: Scalar360.expense-categories.READ, .CREATE, .UPDATE, .DELETE or .ALL. All calls need Authorization: Scalar360-oauthtoken <access_token> — see Authentication.

GET

List

/api/v1/expense-categories

Scope: Scalar360.expense-categories.READ

Parameter	In	Type	Required
`activeOnly`	query	boolean (default false)	No

Example request

curl -X GET "https://api.scalar360.com/api/v1/expense-categories" \
  -H "Authorization: Scalar360-oauthtoken $ACCESS_TOKEN"

POST

Create

/api/v1/expense-categories

Scope: Scalar360.expense-categories.CREATE

Body field	Type	Required	Notes
`name`	string	Yes	required, not blank
`description`	string
`glCode`	string
`monthlyLimit`	number
`perExpenseLimit`	number
`receiptRequiredAbove`	number
`gstEligible`	boolean
`color`	string
`sortOrder`	integer
`active`	boolean
`glAccountId`	string (uuid)

Example request

curl -X POST "https://api.scalar360.com/api/v1/expense-categories" \
  -H "Authorization: Scalar360-oauthtoken $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"string"}'

PUT

Update

/api/v1/expense-categories/{id}

Scope: Scalar360.expense-categories.UPDATE

Parameter	In	Type	Required
`id`	path	string (uuid)	Yes

Body field	Type	Required	Notes
`name`	string	Yes	required, not blank
`description`	string
`glCode`	string
`monthlyLimit`	number
`perExpenseLimit`	number
`receiptRequiredAbove`	number
`gstEligible`	boolean
`color`	string
`sortOrder`	integer
`active`	boolean
`glAccountId`	string (uuid)

Example request

curl -X PUT "https://api.scalar360.com/api/v1/expense-categories/{id}" \
  -H "Authorization: Scalar360-oauthtoken $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","description":"string","glCode":"string","monthlyLimit":100,"perExpenseLimit":100,"receiptRequiredAbove":100}'

DELETE

Delete

/api/v1/expense-categories/{id}

Scope: Scalar360.expense-categories.DELETE

Parameter	In	Type	Required
`id`	path	string (uuid)	Yes

Example request

curl -X DELETE "https://api.scalar360.com/api/v1/expense-categories/{id}" \
  -H "Authorization: Scalar360-oauthtoken $ACCESS_TOKEN"

GET

Gl accounts

/api/v1/expense-categories/gl-accounts

Scope: Scalar360.expense-categories.READ

Example request

curl -X GET "https://api.scalar360.com/api/v1/expense-categories/gl-accounts" \
  -H "Authorization: Scalar360-oauthtoken $ACCESS_TOKEN"