---
title: "Get observations. Filterable by one or more: type of observation, site, observable property, ultimate feature of interest"
method: GET
path: "/ecology/api/v1/observations"
tags: ["observations"]
---

# Get observations. Filterable by one or more: type of observation, site, observable property, ultimate feature of interest

`GET /ecology/api/v1/observations`

## Request

- Base URL: `https://environment.data.gov.uk` (the document declares no server; this is the origin it was published from)
- URL: `https://environment.data.gov.uk/ecology/api/v1/observations`
- Auth: none declared
- TypeScript: <https://skmtc.dev/environment-agency/apis/environment-agency-ecology-and-fish-data-api/docs/ecology/api/v1/observations/get.ts> (a function with typed inputs; its response is checked against the schema)

In the Ecology API, the most central point of interest are the **Observations**. Each observation has a single result for a particular **Observable Property** for a particular **Feature of Interest**.
This API accesses hundreds of thousands of surveys and many millions of observations, this means this endpoint requires _at least one_ filter of **site**, **observable property**, **observation type** or **ultimate feature of interest**.
Example calls:
Get observations from Jan 2020 of WHPT_ASPT or WHPT_TOTAL metrics
`/ecology/api/v1/observations?skip=0&take=250&date_from=2020-01-01&date_to=2020-01-31&property_id=http%3A%2F%2Fenvironment.data.gov.uk%2Fecology%2Fdef%2Fbio%2FWhptAspt&property_id=http%3A%2F%2Fenvironment.data.gov.uk%2Fecology%2Fdef%2Fbio%2FWhptTotal`

Get observations from two sites
`/ecology/api/v1/observations?skip=0&take=250&site_id=http%3A%2F%2Fenvironment.data.gov.uk%2Fecology%2Fsite%2Fbio%2F10254&site_id=http%3A%2F%2Fenvironment.data.gov.uk%2Fecology%2Fsite%2Fbio%2F159200`

Get a particular type of observation from a site taken since Jan 1st 2020 
`/ecology/api/v1/observations?skip=0&take=250site_id=http%3A%2F%2Fenvironment.data.gov.uk%2Fecology%2Fsite%2Fbio%2F10982&type_id=http%3A%2F%2Fenvironment.data.gov.uk%2Fecology%2Fdef%2Fbio%2FRiverInvMetricsObservation&date_from=2020-01-01`

Get observations for a particular feature of interest
`/ecology/api/v1/observations?skip=0&take=250&ultimate_foi_id=http%3A%2F%2Fenvironment.data.gov.uk%2Fecology%2Fspecies%2Ffish%2F194`

## Query parameters

- `skip` integer
- `take` integer
- `type_id` string
- `site_id` string
- `property_id` string
- `ultimate_foi_id` string
- `date_to` string
- `date_from` string

## Response `default`

Default response

---

[API](https://skmtc.dev/environment-agency/apis/environment-agency-ecology-and-fish-data-api.md) - [All operations](https://skmtc.dev/environment-agency/apis/environment-agency-ecology-and-fish-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/environment-agency/apis/environment-agency-ecology-and-fish-data-api/revisions/12337a486753?raw)