---
title: "Find cited limits for one substance or measure"
method: GET
path: "/limits"
---

# Find cited limits for one substance or measure

`GET /limits`

## Request

- Base URL: `https://passage-data.com/api/v1`
- URL: `https://passage-data.com/api/v1/limits`
- Auth: one of:
  - none
  - HTTP bearer
  - API key in header `x-api-key`

## Query parameters

- `parameter` string, required
- `place` string
- `medium` 'water_discharge' | 'surface_water' | 'groundwater' | 'drinking_water' | 'soil' | 'ambient_air' | 'air_emission' | 'sediment' | 'leachate'
- `statistic` string
- `kind` 'limit' | 'guideline' | 'benchmark' | 'threshold' | 'objective' | 'acceptance' | 'printed_reference'
- `max_rows` integer
- `offset` integer

## Response `200`

Rows, or a `refused` block (rows.none_held, parameter.unknown, parameter.ambiguous, place.not_held)

- Limits
  - `query` object
  - `searched` object
  - `total` integer
  - `offset` integer
  - `returned` integer
  - `next_offset` integer, nullable
  - `rows` Row[]
    - `parameter` string
    - `parameter_key` string
    - `value` string
    - `value_num` number, nullable
    - `range` unknown
    - `unit` string, nullable
    - `statistic` string, nullable
    - `direction` string, nullable
    - `kind` string
    - `medium` string
    - `place` string[]
    - `conditions` string[]
    - `cite` Cite
      - `instrument` string
      - `title` string
      - `issuer` string, nullable
      - `edition` string, nullable
      - `section` string, nullable
      - `page` union
        - integer
        - string
      - `quote` string, nullable
      - `source_url` string, nullable
      - `source_sha256` string, nullable
      - `source_status` object: What the daily edition watch last saw at the source: status unchanged, changed (with changed_on and says: the rows are as read from the edition named, not yet re-read) or not verified; checked is the day.
        - `checked` string
        - `status` 'unchanged' | 'changed' | 'not verified'
        - `changed_on` string
        - `says` string
      - `note` string: What the register prints beside the value (e.g. a later or earlier value and its date).
      - `table` string
      - `column` string: The register column the value sits in (e.g. mcl, mclg).
  - `refused` object

## Other responses

- `400`: parameter.missing

---

[API](https://skmtc.dev/passage-data/apis/passage-data-cited-environmental-limits.md) · [All operations](https://skmtc.dev/passage-data/apis/passage-data-cited-environmental-limits/llms.txt) · [OpenAPI document](https://skmtc.dev/passage-data/apis/passage-data-cited-environmental-limits/revisions/ba066708bf53?raw)