---
title: "Fetch observation histograms"
method: GET
path: "/observations/histogram"
tags: ["Observations"]
---

# Fetch observation histograms

`GET /observations/histogram`

## Query parameters

- `acc` 'true' | 'false'
- `captive` 'true' | 'false'
- `endemic` 'true' | 'false'
- `geo` 'true' | 'false'
- `id_please` 'true' | 'false'
- `identified` 'true' | 'false'
- `introduced` 'true' | 'false'
- `mappable` 'true' | 'false'
- `native` 'true' | 'false'
- `out_of_range` 'true' | 'false'
- `pcid` 'true' | 'false'
- `photos` 'true' | 'false'
- `popular` 'true' | 'false'
- `sounds` 'true' | 'false'
- `taxon_is_active` 'true' | 'false'
- `threatened` 'true' | 'false'
- `verifiable` 'true' | 'false'
- `id` union[]
  - union
    - string, uuid
    - integer
    - string
- `not_id` string[]
- `license` string[]
- `photo_license` string[]
- `licensed` 'true' | 'false'
- `photo_licensed` 'true' | 'false'
- `place_id` union[]
  - union
    - string, uuid
    - integer
    - string
- `project_id` union[]
  - union
    - integer
    - string
- `coords_viewable_for_proj` 'true' | 'false'
- `rank` string[]
- `site_id` integer[]
- `sound_license` string[]
- `taxon_id` integer[]
- `without_taxon_id` integer[]
- `taxon_name` string
- `user_id` string[]
- `user_login` string[]
- `hour` integer[]
- `day` integer[]
- `month` integer[]
- `year` integer[]
- `created_day` integer[]
- `created_month` integer[]
- `created_year` integer[]
- `term_id` integer[]
- `term_value_id` integer[]
- `without_term_value_id` integer[]
- `term_id_or_unknown` integer[]
- `annotation_user_id` string[]
- `acc_above` integer
- `acc_below` integer
- `acc_below_or_unknown` integer
- `d1` string
- `d2` string
- `created_d1` string
- `created_d2` string
- `created_on` string
- `observed_on` string
- `unobserved_by_user_id` string
- `apply_project_rules_for` string
- `observation_accuracy_experiment_id` integer[]
- `cs` string
- `csa` string
- `csi` string[]
- `geoprivacy` string[]
- `taxon_geoprivacy` string[]
- `obscuration` string[]
- `hrank` string[]
- `lrank` string[]
- `iconic_taxa` string[]
- `id_above` integer
- `id_below` integer
- `identifications` 'most_agree' | 'most_disagree' | 'some_agree'
- `disagreements` 'true' | 'false'
- `lat` number, float
- `lng` number, float
- `radius` number, float
- `nelat` number, float
- `nelng` number, float
- `swlat` number, float
- `swlng` number, float
- `list_id` integer
- `not_in_project` string[]
- `not_matching_project_rules_for` string
- `q` string
- `search_on` 'names' | 'tags' | 'description' | 'place' | 'taxon_page_obs_photos'
- `quality_grade` string[]
- `not_casual_excluding_captive` 'true' | 'false'
- `without_field` string
- `outlink_source` string
- `updated_since` string
- `viewer_id` integer
- `reviewed` 'true' | 'false'
- `expected_nearby` 'true' | 'false'
- `fails_dqa_accurate` 'true' | 'false'
- `fails_dqa_date` 'true' | 'false'
- `fails_dqa_evidence` 'true' | 'false'
- `fails_dqa_location` 'true' | 'false'
- `fails_dqa_needs_id` 'true' | 'false'
- `fails_dqa_recent` 'true' | 'false'
- `fails_dqa_subject` 'true' | 'false'
- `fails_dqa_wild` 'true' | 'false'
- `user_after` string
- `user_before` string
- `locale` string
- `preferred_place_id` integer
- `ttl` integer
- `page` integer
- `per_page` integer
- `order` 'desc' | 'asc'
- `order_by` 'created_at' | 'geo_score' | 'id' | 'observed_on' | 'random' | 'species_guess' | 'updated_at' | 'votes'
- `only_id` 'true' | 'false'
- `fields` unknown
- `date_field` 'observed' | 'created'
- `interval` 'year' | 'month' | 'week' | 'day' | 'hour' | 'month_of_year' | 'week_of_year'

## Headers

- `X-HTTP-Method-Override` string

## Response `200`

An object with observation counts over time.

- ResultsObservationsHistogram
  - `total_results` integer, required
  - `page` integer, required
  - `per_page` integer, required
  - `results` object, required
    - `year` object
    - `month` object
    - `week` object
    - `day` object
    - `hour` object
    - `month_of_year` object
    - `week_of_year` object

---

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