---
title: "Get Horizon Angles"
method: GET
path: "/data/geographic/horizon_angle"
tags: ["Geographic"]
---

# Get Horizon Angles

`GET /data/geographic/horizon_angle`

Returns a circular profile of angles to the horizon for a location at a given latitude, longitude point. The angles are calculated based on the surrounding terrain elevation from a 90m horizontal-resolution digital elevation model.

The angle returned is relative to due north, with negative angles eastwards and positive values westward . Varies from -180 to 180. A value of -90 means east, 0 means north, and 90 means west.

## Query parameters

- `latitude` number, double, nullable, required
- `longitude` number, double, nullable, required
- `azimuth_intervals` integer, nullable, required
- `format` 'json' | 'csv', nullable

## Response `200`

OK

- HorizonAngleResponse
  - `horizon_angles` HorizonAngle[], nullable
    - `azimuth` number, double
    - `angle` number, double
  - `response_status` ResponseStatus
    - `error_code` string, nullable
    - `message` string, nullable
    - `stack_trace` string, nullable
    - `errors` ResponseError[], nullable
      - `error_code` string, nullable
      - `field_name` string, nullable
      - `message` string, nullable
      - `meta` object, nullable
    - `meta` object, nullable

---

[API](https://skmtc.net/solcast/apis/solcast-api.md) · [All operations](https://skmtc.net/solcast/apis/solcast-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solcast/solcast-api/revisions/591461e66c79/schema)