eBird

Explore bird observations from eBird, the Cornell Lab of Ornithology's global birding database: recent and notable sightings by region or near a point, historical records, checklists, hotspots, regional Top 100 leaderboards, species lists, and the eBird taxonomy.

Actions

Action	What it does
Checklist feed on a date	Get the checklists submitted in a region on a specific date.
eBird taxonomy	Get the eBird taxonomy: the code, common name, scientific name, and family for birds.
Historic observations on a date	Get the observations reported from a region on one specific past date.
Hotspot info	Get details about a single hotspot by its location id (for example L99381).
Hotspots in a region	List the birding hotspots within a region.
List sub-regions	List the sub-regions of a parent region: the countries of the world, the states/provinces of a country, or the counties of a state or province.
Nearby hotspots	List birding hotspots within a radius of a latitude/longitude.
Nearest observations of a species	Find the closest recent places a specific species has been reported to a latitude/longitude.
Recent checklists feed	Get the most recently submitted checklists in a region.
Recent nearby notable observations	Get recent observations of locally rare or unusual (notable) birds within a radius of a latitude/longitude.
Recent nearby observations	Get the most recent observation of each species reported within a radius of a latitude/longitude.
Recent nearby observations of a species	Get recent observations of one specific species within a radius of a latitude/longitude.
Recent notable observations in a region	Get recent observations of locally rare or unusual (notable) birds reported in a region.
Recent observations in a region	Get the most recent observation of each species reported in a region within the last few days.
Recent observations of a species in a region	Get recent observations of one specific species reported in a region.
Region info	Get the name and bounding box of a region.
Regional statistics on a date	Get the number of checklists, contributors, and species reported in a region on a specific date.
Species list for a region	Get the eBird species codes of every species ever reported in a region, in taxonomic order.
Taxonomic forms	List the subspecies and other form codes that roll up into a species.
Taxonomic groups	List the bird groups (families such as 'Ducks, Geese, and Waterfowl') in eBird or Merlin display order.
Taxonomy locales	List the languages (locales) that eBird can return species common names in.
Taxonomy versions	List the available eBird taxonomy versions and flag which one is the latest.
Top 100 contributors	Get the Top 100 eBirders in a region on a specific date, ranked by species seen or by complete checklists.
View a checklist	Get the full details of a single checklist by its submission id (for example S123456789), including every species reported.

Checklist feed on a date

Get the checklists submitted in a region on a specific date.

Inputs

CountrycountrytextRequired: The country to search. Narrow it down with the state/province and county pickers below.
State / province / regionsubnational1text: Optional: narrow the search to a state, province, or region.
County / districtsubnational2text: Optional: narrow the search to a county or district.
DatedatedateRequired: The date to look up.
Sort bysort_keytext: Order the checklists by observation date or by when they were submitted. Defaults to observation date.One of: obs_dt (Observation date), creation_dt (Submission time). Default: obs_dt.
Max resultsmax_resultsnumber: How many results to return, from 1 to 200. Defaults to 10.From 1 to 200. Default: 10.

Outputs

checklistslist: The checklists on that date.

Example output

{
  "checklists": [
    {
      "locId": "L99381",
      "numSpecies": 25,
      "obsDt": "12 Aug 2026",
      "obsTime": "07:45",
      "subId": "S123456789",
      "userDisplayName": "Jane Birder"
    }
  ]
}

eBird taxonomy

Get the eBird taxonomy: the code, common name, scientific name, and family for birds. Filter by category or by specific species to keep the response small.

Inputs

Categoriescategorylist: Limit to certain taxonomic categories. Defaults to all of them.One or more of: species, hybrid, domestic, form, intergrade, issf (Subspecies (ISSF)), slash (Slash (one of two species)), spuh (Spuh (genus-level / unidentified)).
Speciesspecieslist: Optional: limit the taxonomy to specific species. Leave blank to return the entire taxonomy.
Common-name languagelocaletext: Language for common names. Defaults to English.
Taxonomy versionversiontext: Optional: a specific taxonomy version, e.g. 2024. Defaults to the latest.

Outputs

taxalist: The taxonomy entries.

Example output

{
  "taxa": [
    {
      "bandingCodes": [
        "CANG"
      ],
      "category": "species",
      "comName": "Canada Goose",
      "comNameCodes": [
        "CAGO"
      ],
      "familyCode": "anatid1",
      "familyComName": "Ducks, Geese, and Waterfowl",
      "familySciName": "Anatidae",
      "order": "Anseriformes",
      "sciName": "Branta canadensis",
      "sciNameCodes": [
        "BRCA"
      ],
      "speciesCode": "cangoo",
      "taxonOrder": 264.0
    }
  ]
}

Historic observations on a date

Get the observations reported from a region on one specific past date.

Inputs

CountrycountrytextRequired: The country to search. Narrow it down with the state/province and county pickers below.
State / province / regionsubnational1text: Optional: narrow the search to a state, province, or region.
County / districtsubnational2text: Optional: narrow the search to a county or district.
DatedatedateRequired: The date to look up.
Categoriescategorylist: Limit to certain taxonomic categories. Defaults to all of them.One or more of: species, hybrid, domestic, form, intergrade, issf (Subspecies (ISSF)), slash (Slash (one of two species)), spuh (Spuh (genus-level / unidentified)).
Detaildetailtext: How much detail to return per sighting. 'Full' adds checklist and observer fields. Defaults to Simple.One of: simple, full. Default: simple.
Hotspots onlyhotspottrue/false: Only include sightings made at eBird hotspots. Defaults to off.Default: false.
Include unreviewedinclude_provisionaltrue/false: Include sightings not yet reviewed by a moderator. Defaults to off.Default: false.
Max resultsmax_resultsnumber: How many results to return, from 1 to 10000. Defaults to 100.From 1 to 10000. Default: 100.
Which record per speciesranktext: When a species was reported more than once, keep the most recent record or the first one added. Defaults to most recent.One of: mrec (Most recent), create (First reported). Default: mrec.
Common-name languagespp_localetext: Language for species common names. Defaults to English.

Outputs

observationslist: The observations on that date.

Example output

{
  "observations": [
    {
      "comName": "Canada Goose",
      "howMany": 4,
      "lat": 42.4585,
      "lng": -76.5052,
      "locId": "L99381",
      "locName": "Stewart Park",
      "locationPrivate": false,
      "obsDt": "2026-08-12 07:45",
      "obsReviewed": false,
      "obsValid": true,
      "sciName": "Branta canadensis",
      "speciesCode": "cangoo",
      "subId": "S123456789"
    }
  ]
}

Hotspot info

Get details about a single hotspot by its location id (for example L99381).

Inputs

Location IDlocation_idtextRequired: The hotspot's location id, e.g. L99381. You can reference a locId from a hotspot or observation step.

Outputs

hotspotobject: The hotspot's location details.

Example output

{
  "hotspot": {
    "countryCode": "US",
    "countryName": "United States",
    "hierarchicalName": "Stewart Park, Tompkins, New York, US",
    "isHotspot": true,
    "latitude": 42.4585,
    "locId": "L99381",
    "longitude": -76.5052,
    "name": "Stewart Park",
    "subnational1Code": "US-NY",
    "subnational1Name": "New York",
    "subnational2Code": "US-NY-109",
    "subnational2Name": "Tompkins"
  }
}

Hotspots in a region

List the birding hotspots within a region.

Inputs

CountrycountrytextRequired: The country to search. Narrow it down with the state/province and county pickers below.
State / province / regionsubnational1text: Optional: narrow the search to a state, province, or region.
County / districtsubnational2text: Optional: narrow the search to a county or district.
Visited within (days)backnumber: Only include hotspots visited within this many days, from 1 to 30. Leave blank for all hotspots.From 1 to 30.

Outputs

hotspotslist: The hotspots in the region.

Example output

{
  "hotspots": [
    {
      "countryCode": "US",
      "lat": 42.4585,
      "latestObsDt": "2026-08-12 07:45",
      "lng": -76.5052,
      "locId": "L99381",
      "locName": "Stewart Park",
      "numSpeciesAllTime": 251,
      "subnational1Code": "US-NY",
      "subnational2Code": "US-NY-109"
    }
  ]
}

List sub-regions

List the sub-regions of a parent region: the countries of the world, the states/provinces of a country, or the counties of a state or province.

Inputs

Sub-region typeregion_typetextRequired: Which level of sub-region to list.One of: country (Countries), subnational1 (States / provinces), subnational2 (Counties / districts).
Parent regionparent_regiontextRequired: The parent region code to list within. Use 'world' to list every country; a country code like US to list its states/provinces; or a state code like US-NY to list its counties.Default: world.

Outputs

regionslist: The sub-regions.

Example output

{
  "regions": [
    {
      "code": "US-NY",
      "name": "New York"
    },
    {
      "code": "US-NJ",
      "name": "New Jersey"
    }
  ]
}

Nearby hotspots

List birding hotspots within a radius of a latitude/longitude.

Inputs

LatitudelatnumberRequired: Latitude of the point to search around, from -90 to 90.From -90.0 to 90.0.
LongitudelngnumberRequired: Longitude of the point to search around, from -180 to 180. Locations in the Americas take a negative longitude.From -180.0 to 180.0.
Search radius (km)distnumber: How far from the point to search, from 0 to 50 km. Defaults to 25.From 0 to 50. Default: 25.
Visited within (days)backnumber: Only include hotspots visited within this many days, from 1 to 30. Leave blank for all hotspots.From 1 to 30.

Outputs

hotspotslist: The nearby hotspots.

Example output

{
  "hotspots": [
    {
      "countryCode": "US",
      "lat": 42.4585,
      "latestObsDt": "2026-08-12 07:45",
      "lng": -76.5052,
      "locId": "L99381",
      "locName": "Stewart Park",
      "numSpeciesAllTime": 251,
      "subnational1Code": "US-NY",
      "subnational2Code": "US-NY-109"
    }
  ]
}

Nearest observations of a species

Find the closest recent places a specific species has been reported to a latitude/longitude.

Inputs

Speciesspecies_codetextRequired: Pick a bird species, or reference a species code from a previous step.
LatitudelatnumberRequired: Latitude of the point to search around, from -90 to 90.From -90.0 to 90.0.
LongitudelngnumberRequired: Longitude of the point to search around, from -180 to 180. Locations in the Americas take a negative longitude.From -180.0 to 180.0.
Search radius (km)distnumber: How far from the point to search, from 0 to 50 km. Defaults to 25.From 0 to 50. Default: 25.
Days backbacknumber: How many days back to include, from 1 to 30. Defaults to 14.From 1 to 30. Default: 14.
Hotspots onlyhotspottrue/false: Only include sightings made at eBird hotspots. Defaults to off.Default: false.
Include unreviewedinclude_provisionaltrue/false: Include sightings not yet reviewed by a moderator. Defaults to off.Default: false.
Max resultsmax_resultsnumber: How many results to return, from 1 to 3000. Defaults to 100.From 1 to 3000. Default: 100.
Common-name languagespp_localetext: Language for species common names. Defaults to English.

Outputs

observationslist: The nearest observations, closest first.

Example output

{
  "observations": [
    {
      "comName": "Canada Goose",
      "howMany": 4,
      "lat": 42.4585,
      "lng": -76.5052,
      "locId": "L99381",
      "locName": "Stewart Park",
      "locationPrivate": false,
      "obsDt": "2026-08-12 07:45",
      "obsReviewed": false,
      "obsValid": true,
      "sciName": "Branta canadensis",
      "speciesCode": "cangoo",
      "subId": "S123456789"
    }
  ]
}

Recent checklists feed

Get the most recently submitted checklists in a region.

Inputs

CountrycountrytextRequired: The country to search. Narrow it down with the state/province and county pickers below.
State / province / regionsubnational1text: Optional: narrow the search to a state, province, or region.
County / districtsubnational2text: Optional: narrow the search to a county or district.
Max resultsmax_resultsnumber: How many results to return, from 1 to 200. Defaults to 10.From 1 to 200. Default: 10.

Outputs

checklistslist: The recent checklists.

Example output

{
  "checklists": [
    {
      "loc": {
        "locId": "L99381",
        "name": "Stewart Park"
      },
      "locId": "L99381",
      "numSpecies": 25,
      "obsDt": "12 Aug 2026",
      "obsTime": "07:45",
      "subId": "S123456789",
      "userDisplayName": "Jane Birder"
    }
  ]
}

Recent nearby notable observations

Get recent observations of locally rare or unusual (notable) birds within a radius of a latitude/longitude.

Inputs

LatitudelatnumberRequired: Latitude of the point to search around, from -90 to 90.From -90.0 to 90.0.
LongitudelngnumberRequired: Longitude of the point to search around, from -180 to 180. Locations in the Americas take a negative longitude.From -180.0 to 180.0.
Search radius (km)distnumber: How far from the point to search, from 0 to 50 km. Defaults to 25.From 0 to 50. Default: 25.
Days backbacknumber: How many days back to include, from 1 to 30. Defaults to 14.From 1 to 30. Default: 14.
Detaildetailtext: How much detail to return per sighting. 'Full' adds checklist and observer fields. Defaults to Simple.One of: simple, full. Default: simple.
Hotspots onlyhotspottrue/false: Only include sightings made at eBird hotspots. Defaults to off.Default: false.
Max resultsmax_resultsnumber: How many results to return, from 1 to 10000. Defaults to 100.From 1 to 10000. Default: 100.
Common-name languagespp_localetext: Language for species common names. Defaults to English.

Outputs

observationslist: The recent nearby notable observations.

Example output

{
  "observations": [
    {
      "comName": "Canada Goose",
      "howMany": 4,
      "lat": 42.4585,
      "lng": -76.5052,
      "locId": "L99381",
      "locName": "Stewart Park",
      "locationPrivate": false,
      "obsDt": "2026-08-12 07:45",
      "obsReviewed": false,
      "obsValid": true,
      "sciName": "Branta canadensis",
      "speciesCode": "cangoo",
      "subId": "S123456789"
    }
  ]
}

Recent nearby observations

Get the most recent observation of each species reported within a radius of a latitude/longitude.

Inputs

LatitudelatnumberRequired: Latitude of the point to search around, from -90 to 90.From -90.0 to 90.0.
LongitudelngnumberRequired: Longitude of the point to search around, from -180 to 180. Locations in the Americas take a negative longitude.From -180.0 to 180.0.
Search radius (km)distnumber: How far from the point to search, from 0 to 50 km. Defaults to 25.From 0 to 50. Default: 25.
Days backbacknumber: How many days back to include, from 1 to 30. Defaults to 14.From 1 to 30. Default: 14.
Categoriescategorylist: Limit to certain taxonomic categories. Defaults to all of them.One or more of: species, hybrid, domestic, form, intergrade, issf (Subspecies (ISSF)), slash (Slash (one of two species)), spuh (Spuh (genus-level / unidentified)).
Hotspots onlyhotspottrue/false: Only include sightings made at eBird hotspots. Defaults to off.Default: false.
Include unreviewedinclude_provisionaltrue/false: Include sightings not yet reviewed by a moderator. Defaults to off.Default: false.
Max resultsmax_resultsnumber: How many results to return, from 1 to 10000. Defaults to 100.From 1 to 10000. Default: 100.
Sort bysorttext: Order the results by date or by species. Defaults to date.One of: date (Most recent first), species (By species). Default: date.
Common-name languagespp_localetext: Language for species common names. Defaults to English.

Outputs

observationslist: The recent nearby observations.

Example output

{
  "observations": [
    {
      "comName": "Canada Goose",
      "howMany": 4,
      "lat": 42.4585,
      "lng": -76.5052,
      "locId": "L99381",
      "locName": "Stewart Park",
      "locationPrivate": false,
      "obsDt": "2026-08-12 07:45",
      "obsReviewed": false,
      "obsValid": true,
      "sciName": "Branta canadensis",
      "speciesCode": "cangoo",
      "subId": "S123456789"
    }
  ]
}

Recent nearby observations of a species

Get recent observations of one specific species within a radius of a latitude/longitude.

Inputs

Speciesspecies_codetextRequired: Pick a bird species, or reference a species code from a previous step.
LatitudelatnumberRequired: Latitude of the point to search around, from -90 to 90.From -90.0 to 90.0.
LongitudelngnumberRequired: Longitude of the point to search around, from -180 to 180. Locations in the Americas take a negative longitude.From -180.0 to 180.0.
Search radius (km)distnumber: How far from the point to search, from 0 to 50 km. Defaults to 25.From 0 to 50. Default: 25.
Days backbacknumber: How many days back to include, from 1 to 30. Defaults to 14.From 1 to 30. Default: 14.
Hotspots onlyhotspottrue/false: Only include sightings made at eBird hotspots. Defaults to off.Default: false.
Include unreviewedinclude_provisionaltrue/false: Include sightings not yet reviewed by a moderator. Defaults to off.Default: false.
Max resultsmax_resultsnumber: How many results to return, from 1 to 10000. Defaults to 100.From 1 to 10000. Default: 100.
Common-name languagespp_localetext: Language for species common names. Defaults to English.

Outputs

observationslist: The recent nearby observations.

Example output

{
  "observations": [
    {
      "comName": "Canada Goose",
      "howMany": 4,
      "lat": 42.4585,
      "lng": -76.5052,
      "locId": "L99381",
      "locName": "Stewart Park",
      "locationPrivate": false,
      "obsDt": "2026-08-12 07:45",
      "obsReviewed": false,
      "obsValid": true,
      "sciName": "Branta canadensis",
      "speciesCode": "cangoo",
      "subId": "S123456789"
    }
  ]
}

Recent notable observations in a region

Get recent observations of locally rare or unusual (notable) birds reported in a region.

Inputs

CountrycountrytextRequired: The country to search. Narrow it down with the state/province and county pickers below.
State / province / regionsubnational1text: Optional: narrow the search to a state, province, or region.
County / districtsubnational2text: Optional: narrow the search to a county or district.
Days backbacknumber: How many days back to include, from 1 to 30. Defaults to 14.From 1 to 30. Default: 14.
Detaildetailtext: How much detail to return per sighting. 'Full' adds checklist and observer fields. Defaults to Simple.One of: simple, full. Default: simple.
Hotspots onlyhotspottrue/false: Only include sightings made at eBird hotspots. Defaults to off.Default: false.
Max resultsmax_resultsnumber: How many results to return, from 1 to 10000. Defaults to 100.From 1 to 10000. Default: 100.
Common-name languagespp_localetext: Language for species common names. Defaults to English.

Outputs

observationslist: The recent notable observations.

Example output

{
  "observations": [
    {
      "comName": "Canada Goose",
      "howMany": 4,
      "lat": 42.4585,
      "lng": -76.5052,
      "locId": "L99381",
      "locName": "Stewart Park",
      "locationPrivate": false,
      "obsDt": "2026-08-12 07:45",
      "obsReviewed": false,
      "obsValid": true,
      "sciName": "Branta canadensis",
      "speciesCode": "cangoo",
      "subId": "S123456789"
    }
  ]
}

Recent observations in a region

Get the most recent observation of each species reported in a region within the last few days.

Inputs

CountrycountrytextRequired: The country to search. Narrow it down with the state/province and county pickers below.
State / province / regionsubnational1text: Optional: narrow the search to a state, province, or region.
County / districtsubnational2text: Optional: narrow the search to a county or district.
Days backbacknumber: How many days back to include, from 1 to 30. Defaults to 14.From 1 to 30. Default: 14.
Categoriescategorylist: Limit to certain taxonomic categories. Defaults to all of them.One or more of: species, hybrid, domestic, form, intergrade, issf (Subspecies (ISSF)), slash (Slash (one of two species)), spuh (Spuh (genus-level / unidentified)).
Hotspots onlyhotspottrue/false: Only include sightings made at eBird hotspots. Defaults to off.Default: false.
Include unreviewedinclude_provisionaltrue/false: Include sightings not yet reviewed by a moderator. Defaults to off.Default: false.
Max resultsmax_resultsnumber: How many results to return, from 1 to 10000. Defaults to 100.From 1 to 10000. Default: 100.
Common-name languagespp_localetext: Language for species common names. Defaults to English.

Outputs

observationslist: The recent observations.

Example output

{
  "observations": [
    {
      "comName": "Canada Goose",
      "howMany": 4,
      "lat": 42.4585,
      "lng": -76.5052,
      "locId": "L99381",
      "locName": "Stewart Park",
      "locationPrivate": false,
      "obsDt": "2026-08-12 07:45",
      "obsReviewed": false,
      "obsValid": true,
      "sciName": "Branta canadensis",
      "speciesCode": "cangoo",
      "subId": "S123456789"
    }
  ]
}

Recent observations of a species in a region

Get recent observations of one specific species reported in a region.

Inputs

CountrycountrytextRequired: The country to search. Narrow it down with the state/province and county pickers below.
State / province / regionsubnational1text: Optional: narrow the search to a state, province, or region.
County / districtsubnational2text: Optional: narrow the search to a county or district.
Speciesspecies_codetextRequired: Pick a bird species, or reference a species code from a previous step.
Days backbacknumber: How many days back to include, from 1 to 30. Defaults to 14.From 1 to 30. Default: 14.
Hotspots onlyhotspottrue/false: Only include sightings made at eBird hotspots. Defaults to off.Default: false.
Include unreviewedinclude_provisionaltrue/false: Include sightings not yet reviewed by a moderator. Defaults to off.Default: false.
Max resultsmax_resultsnumber: How many results to return, from 1 to 10000. Defaults to 100.From 1 to 10000. Default: 100.
Common-name languagespp_localetext: Language for species common names. Defaults to English.

Outputs

observationslist: The recent observations.

Example output

{
  "observations": [
    {
      "comName": "Canada Goose",
      "howMany": 4,
      "lat": 42.4585,
      "lng": -76.5052,
      "locId": "L99381",
      "locName": "Stewart Park",
      "locationPrivate": false,
      "obsDt": "2026-08-12 07:45",
      "obsReviewed": false,
      "obsValid": true,
      "sciName": "Branta canadensis",
      "speciesCode": "cangoo",
      "subId": "S123456789"
    }
  ]
}

Region info

Get the name and bounding box of a region.

Inputs

CountrycountrytextRequired: The country to search. Narrow it down with the state/province and county pickers below.
State / province / regionsubnational1text: Optional: narrow the search to a state, province, or region.
County / districtsubnational2text: Optional: narrow the search to a county or district.
Name formatregion_name_formattext: How much of the region name to include. Defaults to Full.One of: detailed, detailednoqual (Detailed (no qualifier)), full, namequal (Name with qualifier), nameonly (Name only), revdetailed (Detailed, reversed). Default: full.

Outputs

regionobject

Example output

{
  "region": {
    "bounds": {
      "maxX": -71.85,
      "maxY": 45.02,
      "minX": -79.76,
      "minY": 40.49
    },
    "result": "New York, United States (US)"
  }
}

Regional statistics on a date

Get the number of checklists, contributors, and species reported in a region on a specific date.

Inputs

CountrycountrytextRequired: The country to search. Narrow it down with the state/province and county pickers below.
State / province / regionsubnational1text: Optional: narrow the search to a state, province, or region.
County / districtsubnational2text: Optional: narrow the search to a county or district.
DatedatedateRequired: The date to look up.

Outputs

statsobject

Example output

{
  "stats": {
    "numChecklists": 1234,
    "numContributors": 210,
    "numSpecies": 320
  }
}

Species list for a region

Get the eBird species codes of every species ever reported in a region, in taxonomic order.

Inputs

CountrycountrytextRequired: The country to search. Narrow it down with the state/province and county pickers below.
State / province / regionsubnational1text: Optional: narrow the search to a state, province, or region.
County / districtsubnational2text: Optional: narrow the search to a county or district.

Outputs

speciesCodeslist: Species codes reported in the region.

Example output

{
  "speciesCodes": [
    "cangoo",
    "mallar3",
    "amecro",
    "rethaw"
  ]
}

Taxonomic forms

List the subspecies and other form codes that roll up into a species.

Inputs

Speciesspecies_codetextRequired: Pick a bird species, or reference a species code from a previous step.

Outputs

speciesCodeslist: The species/form codes for the species.

Example output

{
  "speciesCodes": [
    "cangoo",
    "cangoo1",
    "cangoo2"
  ]
}

Taxonomic groups

List the bird groups (families such as 'Ducks, Geese, and Waterfowl') in eBird or Merlin display order.

Inputs

Orderspecies_groupingtextRequired: Return the groups in eBird taxonomic order or Merlin order.One of: ebird (eBird taxonomic order), merlin (Merlin group order).
Group-name languagegroup_name_localetext: Language for the group names. Defaults to English.

Outputs

groupslist: The taxonomic groups.

Example output

{
  "groups": [
    {
      "groupName": "Ducks, Geese, and Swans",
      "groupOrder": 1,
      "taxonOrderBounds": [
        [
          251.0,
          700.0
        ]
      ]
    }
  ]
}

Taxonomy locales

List the languages (locales) that eBird can return species common names in.

Inputs

None.

Outputs

localeslist: The available locales.

Example output

{
  "locales": [
    {
      "code": "en",
      "lastUpdated": "2024-08-01 00:00:00.0",
      "name": "English"
    },
    {
      "code": "es",
      "lastUpdated": "2024-08-01 00:00:00.0",
      "name": "Spanish"
    }
  ]
}

Taxonomy versions

List the available eBird taxonomy versions and flag which one is the latest.

Inputs

None.

Outputs

versionslist: The taxonomy versions.

Example output

{
  "versions": [
    {
      "authorityVer": 2023.0,
      "latest": false
    },
    {
      "authorityVer": 2024.0,
      "latest": true
    }
  ]
}

Top 100 contributors

Get the Top 100 eBirders in a region on a specific date, ranked by species seen or by complete checklists. eBird supports this at the country or state/province level only, so leave the County field empty.

Inputs

CountrycountrytextRequired: The country to search. Narrow it down with the state/province and county pickers below.
State / province / regionsubnational1text: Optional: narrow the search to a state, province, or region.
County / districtsubnational2text: Optional: narrow the search to a county or district.
DatedatedateRequired: The date to look up.
Rank byranked_bytext: Rank contributors by species seen or complete checklists.One of: spp (Species seen), cl (Complete checklists). Default: spp.
Max resultsmax_resultsnumber: How many results to return, from 1 to 100. Defaults to 100.From 1 to 100. Default: 100.

Outputs

contributorslist: The Top 100 contributors.

Example output

{
  "contributors": [
    {
      "numCompleteChecklists": 42,
      "numSpecies": 150,
      "profileHandle": "MTIzNDU2",
      "rowNum": 1,
      "userDisplayName": "Jane Birder",
      "userId": "USER123456"
    }
  ]
}

View a checklist

Get the full details of a single checklist by its submission id (for example S123456789), including every species reported.

Inputs

Checklist IDchecklist_idtextRequired: The checklist submission id, e.g. S123456789. You can reference a subId from a checklist-feed or observation step.

Outputs

checklistobject: The full checklist, including its observations.

Example output

{
  "checklist": {
    "allObsReported": true,
    "durationHrs": 1.5,
    "locId": "L99381",
    "numObservers": 2,
    "numSpecies": 25,
    "obs": [
      {
        "howManyStr": "4",
        "obsDt": "2026-08-12 07:45",
        "obsId": "OBS123456789",
        "speciesCode": "cangoo"
      }
    ],
    "obsDt": "2026-08-12 07:45",
    "subId": "S123456789"
  }
}

ActionsCopy Anchor Link

Checklist feed on a dateCopy Anchor Link

Inputs

Outputs

eBird taxonomyCopy Anchor Link

Inputs

Outputs

Historic observations on a dateCopy Anchor Link

Inputs

Outputs

Hotspot infoCopy Anchor Link

Inputs

Outputs

Hotspots in a regionCopy Anchor Link

Inputs

Outputs

List sub-regionsCopy Anchor Link

Inputs

Outputs

Nearby hotspotsCopy Anchor Link

Inputs

Outputs

Nearest observations of a speciesCopy Anchor Link

Inputs

Outputs

Recent checklists feedCopy Anchor Link

Inputs

Outputs

Recent nearby notable observationsCopy Anchor Link

Inputs

Outputs

Recent nearby observationsCopy Anchor Link

Inputs

Outputs

Recent nearby observations of a speciesCopy Anchor Link

Inputs

Outputs

Recent notable observations in a regionCopy Anchor Link

Inputs

Outputs

Recent observations in a regionCopy Anchor Link

Inputs

Outputs

Recent observations of a species in a regionCopy Anchor Link

Inputs

Outputs

Region infoCopy Anchor Link

Inputs

Outputs

Regional statistics on a dateCopy Anchor Link

Inputs

Outputs

Species list for a regionCopy Anchor Link

Inputs

Outputs

Taxonomic formsCopy Anchor Link

Inputs

Outputs

Taxonomic groupsCopy Anchor Link

Inputs

Outputs

Taxonomy localesCopy Anchor Link

Inputs

Outputs

Taxonomy versionsCopy Anchor Link

Inputs

Outputs

Top 100 contributorsCopy Anchor Link

Inputs

Outputs

View a checklistCopy Anchor Link

Inputs

Outputs

On this page

Actions

Checklist feed on a date

eBird taxonomy

Historic observations on a date

Hotspot info

Hotspots in a region

List sub-regions

Nearby hotspots

Nearest observations of a species

Recent checklists feed

Recent nearby notable observations

Recent nearby observations

Recent nearby observations of a species

Recent notable observations in a region

Recent observations in a region

Recent observations of a species in a region

Region info

Regional statistics on a date

Species list for a region

Taxonomic forms

Taxonomic groups

Taxonomy locales

Taxonomy versions

Top 100 contributors

View a checklist