---
title: "Retrieve terminator coordinates"
method: GET
path: "/api/v1/utils/terminator"
tags: ["Utilities"]
---

# Retrieve terminator coordinates

`GET /api/v1/utils/terminator`

## 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/utils/terminator`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ucalgary/apis/ucalgary-space-remote-sensing-api/docs/api/v1/utils/terminator/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve coordinates for the terminator. 

The timestamp parameter should be supplied in the format "YYYY-MM-DDTHH:mm:ss". 
UTC is the expected timezone.

The angle parameter is used for retrieving the terminator for civil, nautical, 
or astronomical twilight. Use the values -6.0, -12.0, or -18.0 for each of these 
terminators, respectively.

Notes:
  - The algorithm does not account for altitude at this time
  - By default requests are cached. Use the 'no_cache' parameter to disable this functionality.

## Query parameters

- `timestamp` string, date-time, required
- `angle` number
- `no_cache` boolean

## Response `200`

Terminator coordinates

- Terminator
  - `timestamp` string, date-time, required
  - `coords` unknown[], required
    - unknown

## Other responses

- `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)