Skip to main content
GET
/
api
/
v1
/
location-durations
Location Durations
curl --request GET \
  --url https://api.example.com/api/v1/location-durations
{
  "locations": [
    {
      "name": "Houston",
      "state": "TX",
      "days": 182,
      "facilities": ["Memorial Hospital", "Methodist Hospital"],
      "status": "safe"
    },
    {
      "name": "Phoenix",
      "state": "AZ",
      "days": 310,
      "facilities": ["Banner Health"],
      "status": "approaching"
    }
  ]
}
Returns cumulative days spent at each location across all assignments in a rolling 24-month window. Used to monitor the IRS 12-month rule at the location level.

​
Request

curl -H "Authorization: Bearer <token>" \
  https://app.taxhomebase.com/api/v1/location-durations
No query parameters. This endpoint uses a rolling 24-month window (not year-filtered) because the 12-month rule is cumulative across years.

​
Response

{
  "locations": [
    {
      "name": "Houston",
      "state": "TX",
      "days": 182,
      "facilities": ["Memorial Hospital", "Methodist Hospital"],
      "status": "safe"
    },
    {
      "name": "Phoenix",
      "state": "AZ",
      "days": 310,
      "facilities": ["Banner Health"],
      "status": "approaching"
    }
  ]
}
​
locations[].status
string
Location status relative to the 12-month rule:
  • safe — Less than 270 days
  • approaching — 270–365 days
  • exceeds — More than 365 days
​
locations[].facilities
array
List of facility names at this location.