Get leave type by country

Marco system will provide leave types as required by country law. And Marco system also supports customers to use customized leave types. This interface can be use to get legal required leave types or all leave types that customers can use.

Each leave type contains:

  • Leave type country

  • Leave type name

  • Leave type notes

  • Type - Calendar/ Working

Get leave type

GET /leave-type

Gets all default leave type for a given country.

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Body

Name
Type
Required
Description

country

string

Leave type country Country Code Format: "US" (use ISO 3166 Alpha-2 code)

lang

string

Leave type language format as "EN"/"ZH"

customer_id

number

The unique Marco identifier for your company.

Parameter Example:

{
  "country": "US",
  "lang": "EN",
  "customer_id":"1"
}

Response

[
    {
        "id": 101,
        "country": "CN",
        "customer": 0,
        "day_type": "Working",
        "leave_type_name": "Annual Leave",
        "leave_type_notes": "Employees with 1-10 years of work experience are entitled to 5 days; 10-20 years of work experience, entitled to 10 days; 20 or more years of work experience, entitled to 15 days. Offical holidays and public holidays are not counted in annual leave."
    },
    {
        "id": 102,
        "country": "CN",
        "customer": 0,
        "day_type": "Calendar",
        "leave_type_name": "Sick Leave",
        "leave_type_notes": "The company should provide 3-24 months of sick leave to employees based on their working period.The sick pay should be equal to at least 80% of minimum salary."
    },
    {
        "id": 645,
        "country": "CN",
        "customer": 1,
        "day_type": "",
        "leave_type_name": "Annual Leave"
    },
    {
        "id": 826,
        "country": "CN",
        "customer": 1,
        "day_type": "",
        "leave_type_name": "Other Leave"
    },
    {
        ...
    }
]

Last updated