department

GET

/api/v1/department

Department List

Purpose

Retrieve all departments available in company.

Why would you use this?

Use this API when your system needs to access or synchronize department information from Comany. Departments are commonly used to organize products into high-level business categories.

Information Required

Field	Required	Description
api-token	Yes	Authentication token provided by VasyERP

Information Returned

This API returns department information including:

Department ID

Department Name

Before syncing products, the system can fetch department information and use it to categorize products correctly.

Important Notes

Departments are used as top-level product classifications.

Department IDs should be stored for future product synchronization.

Department information may be referenced by Product APIs and Category APIs.

It is recommended to periodically synchronize department data to keep records up to date.

Request

Header Params

Responses

🟢200

application/json

Bodyapplication/json

🟠403Unauthorized

🟠429Too Many Request

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/department' \
--header 'api-token: {{.in-api-token}}'

Response Example

200 - Example

{
    "status": true,
    "message": "Department List",
    "code": "200",
    "response": {
        "totalCount": 9,
        "items": [
            {
                "departmentId": 55381,
                "departmentName": "FMCG"
            },
            {
                "departmentId": 55380,
                "departmentName": "Grocery"
            },
            {
                "departmentId": 55379,
                "departmentName": "Cafe Items"
            },
            {
                "departmentId": 55374,
                "departmentName": "test44"
            },
            {
                "departmentId": 54844,
                "departmentName": "Testing Party"
            },
            {
                "departmentId": 54825,
                "departmentName": "Testing Department"
            },
            {
                "departmentId": 49157,
                "departmentName": "Other"
            },
            {
                "departmentId": 49123,
                "departmentName": "tesst"
            },
            {
                "departmentId": 49111,
                "departmentName": "Food"
            }
        ]
    }
}

Branch List

department

Department List#

Purpose#

Why would you use this?#

Information Required#

Information Returned#

Important Notes#