City Nature Challenge API

To provide results via the API, a project needs to register with the City Nature Challenge. Please contact organizers at citynaturechallenge.org/contact to participate.

For projects that do not use iNaturalist, the CNC API is available to report results on the Live Results page of the City Nature Challenge website. The Live Results page is a real-time leaderboard that shows the number of observations, species, and participants for each city participating in the City Nature Challenge.

The results are gathered by calling on endpoints of participating organizations and projects. This documentation provides the format for the JSON body required by the CNC API.

Response Format

Below is a snippet that shows an example JSON response required by the CNC API:

{
  "project": {
    "id": "1",
    "title": "Los Angeles"
  },
  "observation_count": 1234,
  "species_count": 567,
  "observers_count": 890
}

Fields

project (required): An object containing the following fields:
- id (integer): The unique identifier of the project.
- title (string): The name of the project.
observation_count (integer): The total number of observations made in the project.
species_count (integer): The total number of species observed in the project.
observers_count (integer): The total number of participants in the project.

Adding a map Collections reference