> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hiveinspect.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Dates and Time Zones: How Hive Date Filters Work

> Hive Inspect API date filters use your organization's time zone unless you send an explicit offset. Every timestamp in a response is returned in UTC.

<Note>
  **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.
</Note>

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

| You send | Example | How Hive reads it |
| - | - | - |
| A date | `2026-01-31` | Midnight at the start of that day in **your organization's time zone** |
| A time without an offset | `2026-01-31T09:00:00` | That clock time in **your organization's time zone** |
| A time with an offset | `2026-01-31T09:00:00Z` or `2026-01-31T09:00:00-08:00` | Exactly as sent |

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:

```bash theme={"theme":{"light":"github-light","dark":"vesper"}}
curl "https://api.hiveinspect.com/v1/inspections?scheduled_after=2026-01-01&scheduled_before=2026-02-01" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## 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.

<Warning>
  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.
</Warning>

## 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`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.