---
title: "Retrieve imaging start and end times for a set of locations"
method: POST
path: "/api/v1/data_distribution/imaging_timeframes"
tags: ["Data Distribution"]
---

# Retrieve imaging start and end times for a set of locations

`POST /api/v1/data_distribution/imaging_timeframes`

## Request

- Base URL: `https://api.phys.ucalgary.ca` (the document declares no server; this is the origin it was published from)
- URL: `https://api.phys.ucalgary.ca/api/v1/data_distribution/imaging_timeframes`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ucalgary/apis/ucalgary-space-remote-sensing-api/docs/api/v1/data_distribution/imaging_timeframes/post.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve imaging start and end times for a set of locations. This is specific to the optical 
instrumentation we provide data for.

The timestamp is expected to be UTC time.

Each location in the 'locations' array can be specified either by a 4-letter site UID, or by
providing geodetic latitude and longitude. If the site_uid is provided, it is resolved to
coordinates using the known observatory list.

Notes:
  - The threshold parameter is the solar zenith angle (in degrees) above which imaging occurs. 
    The default value of 102.0 corresponds to nautical twilight, and what all UCalgary optical
    instruments use.
  - The `site_uid` parameter matching is case insensitive

## Request body

- ImagingTimeframesRequest
  - `timestamp` string, date-time, required
  - `locations` ImagingTimeframeLocation[], required
    - `site_uid` string, nullable
    - `geodetic_latitude` number, nullable
    - `geodetic_longitude` number, nullable
  - `threshold` number

## Response `200`

Imaging times

- ImagingTimeframeResponse[]
  - `timestamp` string, required
  - `site_uid` string, nullable
  - `geodetic_latitude` number, required
  - `geodetic_longitude` number, required
  - `imaging_start` string, date-time, nullable
  - `imaging_end` string, date-time, nullable

## Other responses

- `400`: Invalid request
- `404`: Site not found
- `422`: Validation Error

---

[API](https://skmtc.dev/ucalgary/apis/ucalgary-space-remote-sensing-api.md) - [All operations](https://skmtc.dev/ucalgary/apis/ucalgary-space-remote-sensing-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ucalgary/apis/ucalgary-space-remote-sensing-api/revisions/e451a425b5eb?raw)