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

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.net/environment-agency/apis/environment-agency-ecology-and-fish-data-api.md) · [All operations](https://skmtc.net/environment-agency/apis/environment-agency-ecology-and-fish-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/environment-agency/environment-agency-ecology-and-fish-data-api/revisions/c1ee3b7eb471/schema)