API documentation

POST /state_holidays

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/state_holidays

Create State Holiday.

Create a rule that blocks outbound calls to the listed states on the specified holiday dates.

Params

Param name Description

Param name	Description
states Optional Blank value allowed	States Must be an array of strings. EG: `["abc123", "xzy023"]`
holiday_dates Optional Blank value allowed	Holiday Dates Must be an array of strings. EG: `["abc123", "xzy023"]`
name Optional Blank value allowed	Name Must be a String

states
Optional Blank value allowed

States

Must be an array of strings. EG: ["abc123", "xzy023"]

holiday_dates
Optional Blank value allowed

Holiday Dates

Must be an array of strings. EG: ["abc123", "xzy023"]

name
Optional Blank value allowed

Name

Must be a String

Example Request

curl -X POST 'https://[your-subdomain].trackdrive.com/api/v1/state_holidays/' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "states": [
    "us-ca"
  ],
  "name": "Example State Holiday",
  "holiday_dates": [
    "2026-01-14",
    "2026-01-15"
  ]
}'

Example Response 201

{
  "status": 201,
  "success": true,
  "errors": {},
  "state_holiday": {
    "id": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "type": "StateHoliday",
    "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/state_holidays/a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "routes_edit_path": "/state_holidays/a6af7847-1b1e-4760-ac0d-e1813a6d3a09/edit",
    "external_record_id": null,
    "company_id": 10001,
    "states": [
      "us-ca"
    ],
    "name": "Example State Holiday",
    "holiday_dates": [
      "2026-01-14",
      "2026-01-15"
    ],
    "is_system_template": false
  },
  "metadata": {
    "root": "state_holiday"
  }
}