Skip to main content
The Hive Inspect API is a work in progress. It is available to a small group of accounts today, and the release for everyone is coming very soon. To ask for early access, message us from the chat bubble in your dashboard.
Date filters such as scheduled_after, start_before and updated_since accept a date or a timestamp in ISO 8601 format.

​
How Hive reads a date filter

Your organization’s time zone is the one set in your Hive settings. This means a date filter matches the days on your calendar. An inspection at 9 PM on January 31 counts as January 31, even though it is already February 1 in UTC.

​
Filter a date range

“After” filters include the time you send. “Before” filters stop just short of it. To get every inspection in January, ask for January 1 up to February 1:

​
Timestamps in responses

Every timestamp in a response is in UTC and ends in Z, for example 2026-09-24T16:00:00Z. Convert it to your local time when you display it.
A + in a URL means a space. If you send an offset such as +05:30, encode the plus sign as %2B, for example 2026-01-31T09:00:00%2B05:30. An offset written with Z or - needs no encoding.

​
Birthday filters

The contact stats birthday_after and birthday_before filters take a month and day as MM-DD, for example 12-01. They match the day of the year, whatever the birth year. A range can wrap the new year, such as 12-15 to 01-15.
Last modified on October 2, 2026