List departments
curl --request GET \
--url https://staging-api.usetyms.com/v1/adam/departments \
--header 'X-API-Key: <api-key>'import requests
url = "https://staging-api.usetyms.com/v1/adam/departments"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://staging-api.usetyms.com/v1/adam/departments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"status": "success",
"message": "Departments retrieved successfully",
"data": [
{
"uuid": "dep1234567890abcdef1234567890ab",
"business_uuid": "b1b2b3...",
"name": "Marketing",
"branch_uuid": null,
"deleted": false,
"created_at": "2026-03-05T09:00:00.000000Z"
}
]
}Departments
List departments
Return all departments for the business. Use department_uuid on invoices, bills, expenses, income, and journals to tag transactions.
GET
/
departments
List departments
curl --request GET \
--url https://staging-api.usetyms.com/v1/adam/departments \
--header 'X-API-Key: <api-key>'import requests
url = "https://staging-api.usetyms.com/v1/adam/departments"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://staging-api.usetyms.com/v1/adam/departments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"status": "success",
"message": "Departments retrieved successfully",
"data": [
{
"uuid": "dep1234567890abcdef1234567890ab",
"business_uuid": "b1b2b3...",
"name": "Marketing",
"branch_uuid": null,
"deleted": false,
"created_at": "2026-03-05T09:00:00.000000Z"
}
]
}Authorizations
Business secret tyms_sk_... for business-scoped routes. Partner secret for register-business and referred-business distributor routes.
Query Parameters
Page number.
Page size.
Full-text search.
Pass 1 to return only data without the status/message wrapper.
Available options:
1 Response
200 - application/json
Department list