Taxa

Summary

Classes

Functions

get_taxa(q, is_active, taxon_id, rank, ...)	Search taxa
get_taxa_autocomplete(q, is_active, ...)	Given a query string, return taxa with names starting with the search term
get_taxa_by_id(taxon_id, **params)	Get one or more taxa by ID
get_taxa_iconic(**params)	Get all iconic taxa

Module Contents

pyinaturalist.v2.taxa.get_taxa(q, is_active, taxon_id, rank, max_rank, min_rank, ...) → dict[str, Any]

Search taxa

Notes

• API reference: GET /taxa

• See iNaturalist API v2 documentation for details on selecting return fields using fields parameter

Parameters:

• q (str | None) – Name must begin with this value

• is_active (bool | None) – Taxon is active

• taxon_id (int | None) – Only show taxa with this ID, or its descendants

• rank (str | None) – Taxon must have this exact rank

• min_rank (str | None) – Taxon must have this rank or higher; overrides rank

• max_rank (str | None) – Taxon must have this rank or lower; overrides rank

• rank_level (int | None) – Taxon must have this rank level. Some example values are 70 (kingdom), 60 (phylum), 50 (class), 40 (order), 30 (family), 20 (genus), 10 (species), 5 (subspecies)

• locale (str | None) – Locale preference for taxon common names

• preferred_place_id (int | None) – Place preference for regional taxon common names

• all_names (bool | None) – Include all taxon names in the response

• id_above (int | None) – Must have an ID above this value

• id_below (int | None) – Must have an ID below this value

• only_id (bool | None) – Return only the record IDs

• parent_id (int | None) – Taxon’s parent must have this ID

• fields (list[str] | dict[str, Any] | None) – Data fields to return in the response

• except_fields (list[str] | None) – Data fields to exclude from the response (and include all others)

• page (int | None) – Page number of results to return

• per_page (int | None) – Number of results to return in a page. The maximum value is generally 200, unless otherwise noted

• order (Optional[Literal['asc', 'desc']]) – Sort order

• order_by (str | None) – Field to sort on

• count_only (bool | None) – Only return a count of results; alias for per_page=0

• reverse (bool | None) – Reverse the order of results; alias for order='descending'

• dry_run (bool | None) – Just log the request instead of sending a real request

• session (Session | None) – An existing Session object to use instead of creating a new one

Example

>>> response = get_taxa(q='vespi', rank=['genus', 'family'], fields='all')
>>> pprint(response)
[52747] Family: Vespidae (Hornets, Paper Wasps, Potter Wasps, and Allies)
[92786] Genus: Vespicula
[646195] Genus: Vespiodes
...

Example Response (default/minimal)

{"total_results": 65, "page": 1, "per_page": 30, "results": [{"id": 52747}, {"id": 84738}, {"id": 70118}, {"id": 131878}, {"id": 471983}, {"id": 124162}, {"id": 466251}, {"id": 362871}, {"id": 886207}, {"id": 752716}, {"id": 882585}, {"id": 270746}, {"id": 560666}, {"id": 1248765}, {"id": 1084105}, {"id": 633966}, {"id": 876493}, {"id": 1312989}, {"id": 1315869}, {"id": 1144011}, {"id": 1234407}, {"id": 472528}, {"id": 907874}, {"id": 84737}, {"id": 605184}, {"id": 983565}, {"id": 1144104}, {"id": 1356906}, {"id": 1237573}, {"id": 1333724}]}

Example Response (all fields)

{"total_results": 65, "page": 1, "per_page": 30, "results": [{"id": 52747, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47201, 124417, 326777, 48740, 52747], "ancestry": "48460/1/47120/372739/47158/184884/47201/124417/326777/48740", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 26329814, "attribution": "(c) Diego F. Cisneros-Heredia, some rights reserved (CC BY-SA), uploaded by Diego F. Cisneros-Heredia", "attribution_name": "Diego F. Cisneros-Heredia", "flags": [], "license_code": "cc-by-sa", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/26329814/medium.jpg", "original_dimensions": {"height": 1448, "width": 1448}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/26329814/square.jpg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/26329814/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 2, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Vespidae", "name": "Vespidae", "observations_count": 1246130, "parent_id": 48740, "preferred_common_name": "Hornets, Paper Wasps, Potter Wasps, and Allies", "rank": "family", "rank_level": 30, "taxon_changes_count": 0, "taxon_schemes_count": 2, "wikipedia_url": "http://en.wikipedia.org/wiki/Vespidae"}, {"id": 84738, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47201, 124417, 326777, 48740, 52747, 84738], "ancestry": "48460/1/47120/372739/47158/184884/47201/124417/326777/48740/52747", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 39392134, "attribution": "(c) Gilles San Martin, some rights reserved (CC BY-SA), uploaded by Gilles San Martin", "attribution_name": "Gilles San Martin", "flags": [], "license_code": "cc-by-sa", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/39392134/medium.jpeg", "original_dimensions": {"height": 1365, "width": 2048}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/39392134/square.jpeg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/39392134/square.jpeg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 2, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Vespinae", "name": "Vespinae", "observations_count": 424977, "parent_id": 52747, "preferred_common_name": "Hornets and Yellowjackets", "rank": "subfamily", "rank_level": 27, "taxon_changes_count": 0, "taxon_schemes_count": 1, "wikipedia_url": "http://en.wikipedia.org/wiki/Vespinae"}, {"id": 70118, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47208, 71130, 372870, 48311, 47951, 1642609, 1642616, 53850, 70118], "ancestry": "48460/1/47120/372739/47158/184884/47208/71130/372870/48311/47951/1642609/1642616/53850", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 38359335, "attribution": "(c) salvatore_infanti, some rights reserved (CC BY-NC), uploaded by salvatore_infanti", "attribution_name": "salvatore_infanti", "flags": [], "license_code": "cc-by-nc", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/medium.jpg", "original_dimensions": {"height": 1365, "width": 2048}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/square.jpg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Nicrophorus vespilloides", "name": "Nicrophorus vespilloides", "observations_count": 5996, "parent_id": 53850, "preferred_common_name": "Lesser Vespillo Burying Beetle", "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 2, "wikipedia_url": "http://en.wikipedia.org/wiki/Nicrophorus_vespilloides"}, {"id": 131878, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47208, 71130, 372870, 48311, 47951, 1642609, 1642616, 53850, 131878], "ancestry": "48460/1/47120/372739/47158/184884/47208/71130/372870/48311/47951/1642609/1642616/53850", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 24573164, "attribution": "(c) Nikolai Vladimirov, some rights reserved (CC BY-NC), uploaded by Nikolai Vladimirov", "attribution_name": "Nikolai Vladimirov", "flags": [], "license_code": "cc-by-nc", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/24573164/medium.jpg", "original_dimensions": {"height": 1365, "width": 2048}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/24573164/square.jpg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/24573164/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Nicrophorus vespillo", "name": "Nicrophorus vespillo", "observations_count": 4440, "parent_id": 53850, "preferred_common_name": "Vespillo Burying Beetle", "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 1, "wikipedia_url": "http://en.wikipedia.org/wiki/Nicrophorus_vespillo"}, {"id": 471983, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47201, 84643, 49452, 60628, 473423, 551369, 60623, 471983], "ancestry": "48460/1/47120/372739/47158/184884/47201/84643/49452/60628/473423/551369/60623", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 22061519, "attribution": "(c) Kasper Malmberg, some rights reserved (CC BY), uploaded by Kasper Malmberg", "attribution_name": "Kasper Malmberg", "flags": [], "license_code": "cc-by", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/22061519/medium.jpg", "original_dimensions": {"height": 1363, "width": 2048}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/22061519/square.jpg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/22061519/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Vespine Sawfly", "name": "Tenthredo vespa", "observations_count": 1185, "parent_id": 60623, "preferred_common_name": "Noble Wasp-sawfly", "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 1, "wikipedia_url": "http://en.wikipedia.org/wiki/Tenthredo_vespa"}, {"id": 124162, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47822, 48091, 372853, 414448, 49995, 326181, 488425, 520026, 124163, 124162], "ancestry": "48460/1/47120/372739/47158/184884/47822/48091/372853/414448/49995/326181/488425/520026/124163", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 138462141, "attribution": "(c) Erland Refling Nielsen, some rights reserved (CC BY-NC)", "attribution_name": "Erland Refling Nielsen", "flags": [], "license_code": "cc-by-nc", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/138462141/medium.jpg", "original_dimensions": {"height": 800, "width": 1200}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/138462141/square.jpg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/138462141/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 1, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Temnostoma vespiforme", "name": "Temnostoma vespiforme", "observations_count": 946, "parent_id": 124163, "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 1, "wikipedia_url": "http://en.wikipedia.org/wiki/Temnostoma_vespiforme"}, {"id": 466251, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47822, 48091, 372853, 414448, 49995, 326181, 520014, 125658, 466251], "ancestry": "48460/1/47120/372739/47158/184884/47822/48091/372853/414448/49995/326181/520014/125658", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 364136161, "attribution": "(c) Valter Jacinto, all rights reserved, uploaded by Valter Jacinto", "attribution_name": "Valter Jacinto", "flags": [], "license_code": null, "medium_url": "https://static.inaturalist.org/photos/364136161/medium.jpeg", "original_dimensions": {"height": 900, "width": 1200}, "square_url": "https://static.inaturalist.org/photos/364136161/square.jpeg", "url": "https://static.inaturalist.org/photos/364136161/square.jpeg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Ceriana vespiformis", "name": "Ceriana vespiformis", "observations_count": 386, "parent_id": 125658, "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 1, "wikipedia_url": "http://en.wikipedia.org/wiki/Ceriana_vespiformis"}, {"id": 362871, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47157, 752400, 51573, 456401, 366342, 51684, 362871], "ancestry": "48460/1/47120/372739/47158/184884/47157/752400/51573/456401/366342/51684", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 56652702, "attribution": "(c) gernotkunz, all rights reserved, uploaded by gernotkunz", "attribution_name": "gernotkunz", "flags": [], "license_code": null, "medium_url": "https://static.inaturalist.org/photos/56652702/medium.jpg", "original_dimensions": {"height": 1365, "width": 2048}, "square_url": "https://static.inaturalist.org/photos/56652702/square.jpg", "url": "https://static.inaturalist.org/photos/56652702/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "S\u00e9sie vespiforme", "name": "Synanthedon vespiformis", "observations_count": 360, "parent_id": 51684, "preferred_common_name": "Yellow-legged Clearwing Moth", "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 1, "wikipedia_url": "http://en.wikipedia.org/wiki/Synanthedon_vespiformis"}, {"id": 886207, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47201, 124417, 326777, 48740, 52747, 119344, 428969, 886207], "ancestry": "48460/1/47120/372739/47158/184884/47201/124417/326777/48740/52747/119344/428969", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 101861196, "attribution": "(c) Erland Refling Nielsen, some rights reserved (CC BY-NC)", "attribution_name": "Erland Refling Nielsen", "flags": [], "license_code": "cc-by-nc", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/101861196/medium.jpg", "original_dimensions": {"height": 667, "width": 1000}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/101861196/square.jpg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/101861196/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Hypodynerus vespiformis", "name": "Hypodynerus vespiformis", "observations_count": 298, "parent_id": 428969, "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 1, "wikipedia_url": null}, {"id": 752716, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47201, 124417, 326777, 48740, 52747, 343248, 531700, 752711, 752716], "ancestry": "48460/1/47120/372739/47158/184884/47201/124417/326777/48740/52747/343248/531700/752711", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 28041688, "attribution": "(c) beatrizbrasilr, all rights reserved", "attribution_name": "beatrizbrasilr", "flags": [], "license_code": null, "medium_url": "https://static.inaturalist.org/photos/28041688/medium.jpg", "original_dimensions": {"height": 2048, "width": 1476}, "square_url": "https://static.inaturalist.org/photos/28041688/square.jpg", "url": "https://static.inaturalist.org/photos/28041688/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Pseudopolybia vespiceps vespiceps", "name": "Pseudopolybia vespiceps", "observations_count": 90, "parent_id": 752711, "rank": "species", "rank_level": 10, "taxon_changes_count": 1, "taxon_schemes_count": 1, "wikipedia_url": null}, {"id": 882585, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47201, 124417, 326777, 47222, 51955, 210928, 210927, 507574, 53067, 882585], "ancestry": "48460/1/47120/372739/47158/184884/47201/124417/326777/47222/51955/210928/210927/507574/53067", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 33808490, "attribution": "(c) birdnerd1, all rights reserved", "attribution_name": "birdnerd1", "flags": [], "license_code": null, "medium_url": "https://static.inaturalist.org/photos/33808490/medium.jpeg", "original_dimensions": {"height": 1200, "width": 795}, "square_url": "https://static.inaturalist.org/photos/33808490/square.jpeg", "url": "https://static.inaturalist.org/photos/33808490/square.jpeg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Bembix vespiformis", "name": "Bembix vespiformis", "observations_count": 89, "parent_id": 53067, "preferred_common_name": "Panda Sand Wasp", "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 1, "wikipedia_url": null}, {"id": 270746, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 83201, 372872, 1377478, 245155, 252574, 270746], "ancestry": "48460/1/47120/372739/47158/184884/83201/372872/1377478/245155/252574", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 5079943, "attribution": "no rights reserved, uploaded by Jesse Rorabaugh", "attribution_name": "Jesse Rorabaugh", "flags": [], "license_code": "cc0", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/5079943/medium.jpg", "original_dimensions": {"height": 797, "width": 819}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/5079943/square.jpg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/5079943/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Vespiform Thrips", "name": "Franklinothrips vespiformis", "observations_count": 54, "parent_id": 252574, "preferred_common_name": "Vespiform Thrips", "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 2, "wikipedia_url": "http://en.wikipedia.org/wiki/Franklinothrips_vespiformis"}, {"id": 560666, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47201, 124417, 326777, 1269342, 54028, 201315, 366768, 563431, 560666], "ancestry": "48460/1/47120/372739/47158/184884/47201/124417/326777/1269342/54028/201315/366768/563431", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 30741812, "attribution": "(c) Paolo Mazzei, some rights reserved (CC BY-NC), uploaded by Paolo Mazzei", "attribution_name": "Paolo Mazzei", "flags": [], "license_code": "cc-by-nc", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/30741812/medium.jpg", "original_dimensions": {"height": 600, "width": 800}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/30741812/square.jpg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/30741812/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Ctenagenia vespiformis", "name": "Ctenagenia vespiformis", "observations_count": 52, "parent_id": 563431, "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 1, "wikipedia_url": null}, {"id": 1248765, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 48763, 483236, 52955, 474580, 522978, 1248765], "ancestry": "48460/1/47120/372739/47158/184884/48763/483236/52955/474580/522978", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 133746538, "attribution": "(c) Licheng Shih, some rights reserved (CC BY), uploaded by Licheng Shih", "attribution_name": "Licheng Shih", "flags": [], "license_code": "cc-by", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/133746538/medium.jpeg", "original_dimensions": {"height": 1365, "width": 2048}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/133746538/square.jpeg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/133746538/square.jpeg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Euclimacia vespiformis", "name": "Euclimacia vespiformis", "observations_count": 29, "parent_id": 522978, "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 0, "wikipedia_url": null}, {"id": 1084105, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47201, 84643, 49452, 60628, 473423, 551369, 60623, 1353569, 1084105], "ancestry": "48460/1/47120/372739/47158/184884/47201/84643/49452/60628/473423/551369/60623/1353569", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 129307679, "attribution": "(c) C\u00e9line, some rights reserved (CC BY), uploaded by C\u00e9line", "attribution_name": "C\u00e9line", "flags": [], "license_code": "cc-by", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/129307679/medium.jpeg", "original_dimensions": {"height": 1536, "width": 2048}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/129307679/square.jpeg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/129307679/square.jpeg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Tenthredo vespiformis", "name": "Tenthredo vespiformis", "observations_count": 26, "parent_id": 1353569, "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 0, "wikipedia_url": null}, {"id": 633966, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47744, 61267, 372850, 133754, 48959, 320199, 482431, 129424, 1580612, 633966], "ancestry": "48460/1/47120/372739/47158/184884/47744/61267/372850/133754/48959/320199/482431/129424/1580612", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 5292283, "attribution": "(c) Paul, all rights reserved, uploaded by Paul", "attribution_name": "Paul", "flags": [], "license_code": null, "medium_url": "https://static.inaturalist.org/photos/5292283/medium.jpg", "original_dimensions": {"height": 1064, "width": 1580}, "square_url": "https://static.inaturalist.org/photos/5292283/square.jpg", "url": "https://static.inaturalist.org/photos/5292283/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Zelus vespiformis", "name": "Zelus vespiformis", "observations_count": 25, "parent_id": 1580612, "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 1, "wikipedia_url": null}, {"id": 876493, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47822, 48091, 372853, 414448, 49995, 326181, 488425, 520024, 465579, 876493], "ancestry": "48460/1/47120/372739/47158/184884/47822/48091/372853/414448/49995/326181/488425/520024/465579", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 391134119, "attribution": "(c) Roman Providukhin, some rights reserved (CC BY-NC), uploaded by Roman Providukhin", "attribution_name": "Roman Providukhin", "flags": [], "license_code": "cc-by-nc", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/391134119/medium.jpg", "original_dimensions": {"height": 825, "width": 619}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/391134119/square.jpg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/391134119/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Sphecomyia vespiformis", "name": "Sphecomyia vespiformis", "observations_count": 24, "parent_id": 465579, "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 1, "wikipedia_url": "https://en.wikipedia.org/wiki/Sphecomyia_vespiformis"}, {"id": 1312989, "ancestor_ids": [48460, 1, 2, 355675, 47178, 1632273, 47233, 1303568, 64494, 1359801, 1312989], "ancestry": "48460/1/2/355675/47178/1632273/47233/1303568/64494/1359801", "atlas_id": null, "complete_rank": "species", "complete_species_count": 1, "current_synonymous_taxon_ids": null, "default_photo": {"id": 33535972, "attribution": "David Starr Jordan\n, no known copyright restrictions (public domain)", "attribution_name": "David Starr Jordan\n", "flags": [], "license_code": "pd", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/33535972/medium.jpeg", "original_dimensions": {"height": 442, "width": 947}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/33535972/square.jpeg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/33535972/square.jpeg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47178, "iconic_taxon_name": "Actinopterygii", "is_active": true, "matched_term": "Vespicula", "name": "Trichosomus", "observations_count": 24, "parent_id": 1359801, "rank": "genus", "rank_level": 20, "taxon_changes_count": 1, "taxon_schemes_count": 0, "wikipedia_url": null}, {"id": 1315869, "ancestor_ids": [48460, 1, 2, 355675, 47178, 1632273, 47233, 1303568, 64494, 1359801, 1312989, 1315869], "ancestry": "48460/1/2/355675/47178/1632273/47233/1303568/64494/1359801/1312989", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 66470858, "attribution": "(c) Tse Chung Yi, some rights reserved (CC BY-NC), uploaded by Tse Chung Yi", "attribution_name": "Tse Chung Yi", "flags": [], "license_code": "cc-by-nc", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/66470858/medium.jpg", "original_dimensions": {"height": 1536, "width": 2048}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/66470858/square.jpg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/66470858/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47178, "iconic_taxon_name": "Actinopterygii", "is_active": true, "matched_term": "Vespicula Waspfish", "name": "Trichosomus trachinoides", "observations_count": 23, "parent_id": 1312989, "preferred_common_name": "Vespicula Waspfish", "rank": "species", "rank_level": 10, "taxon_changes_count": 1, "taxon_schemes_count": 0, "wikipedia_url": null}, {"id": 1144011, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47744, 125816, 372849, 49025, 49024, 538599, 538600, 462047, 1144011], "ancestry": "48460/1/47120/372739/47158/184884/47744/125816/372849/49025/49024/538599/538600/462047", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 612731268, "attribution": "no rights reserved, uploaded by Jean-Paul Boerekamps", "attribution_name": "Jean-Paul Boerekamps", "flags": [], "license_code": "cc0", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/612731268/medium.jpg", "original_dimensions": {"height": 1633, "width": 2048}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/612731268/square.jpg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/612731268/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Heteronotus vespiformes", "name": "Heteronotus vespiformes", "observations_count": 23, "parent_id": 462047, "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 0, "wikipedia_url": null}, {"id": 1234407, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47744, 61267, 372868, 51776, 62059, 334297, 340814, 1503337, 1234407], "ancestry": "48460/1/47120/372739/47158/184884/47744/61267/372868/51776/62059/334297/340814/1503337", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 110588567, "attribution": "(c) Alexandre_Laporte, some rights reserved (CC BY-NC), uploaded by Alexandre_Laporte", "attribution_name": "Alexandre_Laporte", "flags": [], "license_code": "cc-by-nc", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/110588567/medium.jpg", "original_dimensions": {"height": 1536, "width": 2048}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/110588567/square.jpg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/110588567/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Hyalymenus vespiformis", "name": "Hyalymenus vespiformis", "observations_count": 8, "parent_id": 1503337, "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 0, "wikipedia_url": null}, {"id": 472528, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47157, 51269, 51268, 84737, 472528], "ancestry": "48460/1/47120/372739/47158/184884/47157/51269/51268/84737", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 74234576, "attribution": "(c) Garth Harwood, some rights reserved (CC BY), uploaded by Garth Harwood", "attribution_name": "Garth Harwood", "flags": [], "license_code": "cc-by", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/74234576/medium.jpeg", "original_dimensions": {"height": 1536, "width": 2048}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/74234576/square.jpeg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/74234576/square.jpeg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Vespina quercivora", "name": "Vespina quercivora", "observations_count": 7, "parent_id": 84737, "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 1, "wikipedia_url": "http://en.wikipedia.org/wiki/Vespina_quercivora"}, {"id": 907874, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47157, 47607, 121850, 47606, 82089, 82101, 47988, 907874], "ancestry": "48460/1/47120/372739/47158/184884/47157/47607/121850/47606/82089/82101/47988", "atlas_id": 113143, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 80464655, "attribution": "(c) Mar\u00edlia, some rights reserved (CC BY-NC), uploaded by Mar\u00edlia", "attribution_name": "Mar\u00edlia", "flags": [], "license_code": "cc-by-nc", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/80464655/medium.jpeg", "original_dimensions": {"height": 1365, "width": 2048}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/80464655/square.jpeg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/80464655/square.jpeg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Argyroeides vespina", "name": "Argyroeides vespina", "observations_count": 7, "parent_id": 47988, "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 1, "wikipedia_url": "https://en.wikipedia.org/wiki/Argyroeides_vespina"}, {"id": 84737, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47157, 51269, 51268, 84737], "ancestry": "48460/1/47120/372739/47158/184884/47157/51269/51268", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 144530754, "attribution": "(c) stellifera, some rights reserved (CC BY-NC), uploaded by stellifera", "attribution_name": "stellifera", "flags": [], "license_code": "cc-by-nc", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/144530754/medium.jpg", "original_dimensions": {"height": 1536, "width": 2048}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/144530754/square.jpg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/144530754/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Vespina", "name": "Vespina", "observations_count": 7, "parent_id": 51268, "rank": "genus", "rank_level": 20, "taxon_changes_count": 0, "taxon_schemes_count": 1, "wikipedia_url": "http://en.wikipedia.org/wiki/Vespina"}, {"id": 605184, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47744, 61267, 372868, 51776, 51777, 319231, 570423, 605185, 605184], "ancestry": "48460/1/47120/372739/47158/184884/47744/61267/372868/51776/51777/319231/570423/605185", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 125401043, "attribution": "(c) Esteban Diego Koch, some rights reserved (CC BY-NC), uploaded by Esteban Diego Koch", "attribution_name": "Esteban Diego Koch", "flags": [], "license_code": "cc-by-nc", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/125401043/medium.jpeg", "original_dimensions": {"height": 1365, "width": 2048}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/125401043/square.jpeg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/125401043/square.jpeg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Moronopelios vespiformis", "name": "Moronopelios vespiformis", "observations_count": 7, "parent_id": 605185, "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 1, "wikipedia_url": null}, {"id": 1144104, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47744, 125816, 372849, 49025, 53237, 244341, 153379, 702298, 1144104], "ancestry": "48460/1/47120/372739/47158/184884/47744/125816/372849/49025/53237/244341/153379/702298", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 103251073, "attribution": "(c) Karl Kroeker, some rights reserved (CC BY-NC), uploaded by Karl Kroeker", "attribution_name": "Karl Kroeker", "flags": [], "license_code": "cc-by-nc", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/103251073/medium.jpg", "original_dimensions": {"height": 1463, "width": 2048}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/103251073/square.jpg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/103251073/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Lissoscarta vespiformis", "name": "Lissoscarta vespiformis", "observations_count": 3, "parent_id": 702298, "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 0, "wikipedia_url": null}, {"id": 983565, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47822, 48091, 372865, 354603, 47982, 639471, 639475, 623118, 983565], "ancestry": "48460/1/47120/372739/47158/184884/47822/48091/372865/354603/47982/639471/639475/623118", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 30581879, "attribution": "(c) Richard Yank, all rights reserved, uploaded by Richard Yank", "attribution_name": "Richard Yank", "flags": [], "license_code": null, "medium_url": "https://static.inaturalist.org/photos/30581879/medium.jpg", "original_dimensions": {"height": 1365, "width": 2048}, "square_url": "https://static.inaturalist.org/photos/30581879/square.jpg", "url": "https://static.inaturalist.org/photos/30581879/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Codula vespiformis", "name": "Codula vespiformis", "observations_count": 3, "parent_id": 623118, "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 1, "wikipedia_url": null}, {"id": 1356906, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47201, 124417, 326777, 48740, 52747, 121511, 1283845, 1283847, 708096, 1356906], "ancestry": "48460/1/47120/372739/47158/184884/47201/124417/326777/48740/52747/121511/1283845/1283847/708096", "atlas_id": null, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 116263249, "attribution": "(c) Phil Benstead, some rights reserved (CC BY-NC), uploaded by Phil Benstead", "attribution_name": "Phil Benstead", "flags": [], "license_code": "cc-by-nc", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/116263249/medium.jpeg", "original_dimensions": {"height": 1642, "width": 1990}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/116263249/square.jpeg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/116263249/square.jpeg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Masaris vespiformis", "name": "Masaris vespiformis", "observations_count": 2, "parent_id": 708096, "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 0, "wikipedia_url": null}, {"id": 1237573, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47157, 47607, 121850, 47606, 82089, 123991, 153082, 1237573], "ancestry": "48460/1/47120/372739/47158/184884/47157/47607/121850/47606/82089/123991/153082", "atlas_id": 46220, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 175710613, "attribution": "no rights reserved, uploaded by Andreas Manz", "attribution_name": "Andreas Manz", "flags": [], "license_code": "cc0", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/175710613/medium.jpg", "original_dimensions": {"height": 627, "width": 834}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/175710613/square.jpg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/175710613/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Isanthrene vespiformis", "name": "Isanthrene vespiformis", "observations_count": 2, "parent_id": 153082, "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 0, "wikipedia_url": "https://en.wikipedia.org/wiki/Isanthrene_vespiformis"}, {"id": 1333724, "ancestor_ids": [48460, 1, 47120, 372739, 47158, 184884, 47157, 47607, 121850, 47606, 82089, 82113, 1188588, 1333724], "ancestry": "48460/1/47120/372739/47158/184884/47157/47607/121850/47606/82089/82113/1188588", "atlas_id": 45517, "complete_species_count": null, "current_synonymous_taxon_ids": null, "default_photo": {"id": 174949714, "attribution": "no rights reserved, uploaded by Andreas Manz", "attribution_name": "Andreas Manz", "flags": [], "license_code": "cc0", "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/174949714/medium.jpg", "original_dimensions": {"height": 479, "width": 655}, "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/174949714/square.jpg", "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/174949714/square.jpg"}, "extinct": false, "provisional": false, "flag_counts": {"resolved": 0, "unresolved": 0}, "iconic_taxon_id": 47158, "iconic_taxon_name": "Insecta", "is_active": true, "matched_term": "Metaxanthia vespiformis", "name": "Metaxanthia vespiformis", "observations_count": 1, "parent_id": 1188588, "rank": "species", "rank_level": 10, "taxon_changes_count": 0, "taxon_schemes_count": 0, "wikipedia_url": "https://en.wikipedia.org/wiki/Metaxanthia_vespiformis"}]}

Return type:

dict[str, Any]

Returns:

Response dict containing taxon records

pyinaturalist.v2.taxa.get_taxa_autocomplete(q, is_active, taxon_id, rank, max_rank, min_rank, ...) → dict[str, Any]

Given a query string, return taxa with names starting with the search term

Notes

• API reference: GET /taxa/autocomplete

Parameters:

• q (str | None) – Name must begin with this value

• is_active (bool | None) – Taxon is active

• taxon_id (int | None) – Only show taxa with this ID, or its descendants

• rank (str | None) – Taxon must have this exact rank

• min_rank (str | None) – Taxon must have this rank or higher; overrides rank

• max_rank (str | None) – Taxon must have this rank or lower; overrides rank

• rank_level (int | None) – Taxon must have this rank level. Some example values are 70 (kingdom), 60 (phylum), 50 (class), 40 (order), 30 (family), 20 (genus), 10 (species), 5 (subspecies)

• locale (str | None) – Locale preference for taxon common names

• preferred_place_id (int | None) – Place preference for regional taxon common names

• all_names (bool | None) – Include all taxon names in the response

• fields (list[str] | dict[str, Any] | None) – Data fields to return in the response

• except_fields (list[str] | None) – Data fields to exclude from the response (and include all others)

• dry_run (bool | None) – Just log the request instead of sending a real request

• session (Session | None) –

  An existing Session object to use instead of creating a new one

Example

>>> response = get_taxa_autocomplete(q='vespi')
>>> print(response['results'][0]['name'])
'Vespidae'

Return type:

dict[str, Any]

Returns:

Response dict containing taxon records

pyinaturalist.v2.taxa.get_taxa_by_id(taxon_id, **params) → dict[str, Any]

Get one or more taxa by ID

Notes

• API reference: GET /taxa/{id}

Example

>>> response = get_taxa_by_id(343248)
>>> print(response['results'][0]['name'])
'Polistinae'

Example Response (default/minimal)

{
  "total_results": 1,
  "page": 1,
  "per_page": 30,
  "results": [
    {
      "id": 70118
    }
  ]
}

Example Response (all fields)

{
  "total_results": 1,
  "page": 1,
  "per_page": 30,
  "results": [
    {
      "id": 70118,
      "ancestors": [
        {
          "id": 1,
          "ancestor_ids": [
            48460,
            1
          ],
          "ancestry": "48460",
          "atlas_id": null,
          "complete_rank": "order",
          "complete_species_count": null,
          "current_synonymous_taxon_ids": null,
          "default_photo": {
            "id": 80678745,
            "attribution": "no rights reserved, uploaded by Abhas Misraraj",
            "attribution_name": "Abhas Misraraj",
            "flags": [],
            "license_code": "cc0",
            "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/80678745/medium.jpg",
            "original_dimensions": {
              "height": 2000,
              "width": 2000
            },
            "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/80678745/square.jpg",
            "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/80678745/square.jpg"
          },
          "extinct": false,
          "provisional": false,
          "flag_counts": {
            "resolved": 16,
            "unresolved": 1
          },
          "iconic_taxon_id": 1,
          "iconic_taxon_name": "Animalia",
          "is_active": true,
          "name": "Animalia",
          "observations_count": 166795722,
          "parent_id": 48460,
          "preferred_common_name": "Animals",
          "rank": "kingdom",
          "rank_level": 70,
          "taxon_changes_count": 7,
          "taxon_schemes_count": 2,
          "wikipedia_url": "http://en.wikipedia.org/wiki/Animal"
        },
        {
          "id": 47120,
          "ancestor_ids": [
            48460,
            1,
            47120
          ],
          "ancestry": "48460/1",
          "atlas_id": null,
          "complete_rank": "order",
          "complete_species_count": null,
          "current_synonymous_taxon_ids": null,
          "default_photo": {
            "id": 294541916,
            "attribution": "(c) peter_yeeles, all rights reserved",
            "attribution_name": "peter_yeeles",
            "flags": [],
            "license_code": null,
            "medium_url": "https://static.inaturalist.org/photos/294541916/medium.jpg",
            "original_dimensions": {
              "height": 1366,
              "width": 2048
            },
            "square_url": "https://static.inaturalist.org/photos/294541916/square.jpg",
            "url": "https://static.inaturalist.org/photos/294541916/square.jpg"
          },
          "extinct": false,
          "provisional": false,
          "flag_counts": {
            "resolved": 6,
            "unresolved": 0
          },
          "iconic_taxon_id": 1,
          "iconic_taxon_name": "Animalia",
          "is_active": true,
          "name": "Arthropoda",
          "observations_count": 93146844,
          "parent_id": 1,
          "preferred_common_name": "Arthropods",
          "rank": "phylum",
          "rank_level": 60,
          "taxon_changes_count": 2,
          "taxon_schemes_count": 2,
          "wikipedia_url": "http://en.wikipedia.org/wiki/Arthropod"
        },
        {
          "id": 372739,
          "ancestor_ids": [
            48460,
            1,
            47120,
            372739
          ],
          "ancestry": "48460/1/47120",
          "atlas_id": null,
          "complete_rank": "order",
          "complete_species_count": null,
          "current_synonymous_taxon_ids": null,
          "default_photo": {
            "id": 59424799,
            "attribution": "(c) Damien Brouste, some rights reserved (CC BY-NC), uploaded by Damien Brouste",
            "attribution_name": "Damien Brouste",
            "flags": [],
            "license_code": "cc-by-nc",
            "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/59424799/medium.jpg",
            "original_dimensions": {
              "height": 1366,
              "width": 2048
            },
            "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/59424799/square.jpg",
            "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/59424799/square.jpg"
          },
          "extinct": false,
          "provisional": false,
          "flag_counts": {
            "resolved": 0,
            "unresolved": 0
          },
          "iconic_taxon_id": 1,
          "iconic_taxon_name": "Animalia",
          "is_active": true,
          "name": "Hexapoda",
          "observations_count": 81045527,
          "parent_id": 47120,
          "preferred_common_name": "Hexapods",
          "rank": "subphylum",
          "rank_level": 57,
          "taxon_changes_count": 0,
          "taxon_schemes_count": 2,
          "wikipedia_url": "http://en.wikipedia.org/wiki/Hexapoda"
        },
        {
          "id": 47158,
          "ancestor_ids": [
            48460,
            1,
            47120,
            372739,
            47158
          ],
          "ancestry": "48460/1/47120/372739",
          "atlas_id": null,
          "complete_rank": "order",
          "complete_species_count": null,
          "current_synonymous_taxon_ids": null,
          "default_photo": {
            "id": 18333696,
            "attribution": "(c) TOUROULT Julien, some rights reserved (CC BY), uploaded by TOUROULT Julien",
            "attribution_name": "TOUROULT Julien",
            "flags": [],
            "license_code": "cc-by",
            "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/18333696/medium.jpeg",
            "original_dimensions": {
              "height": 1357,
              "width": 2048
            },
            "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/18333696/square.jpeg",
            "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/18333696/square.jpeg"
          },
          "extinct": false,
          "provisional": false,
          "flag_counts": {
            "resolved": 44,
            "unresolved": 0
          },
          "iconic_taxon_id": 47158,
          "iconic_taxon_name": "Insecta",
          "is_active": true,
          "name": "Insecta",
          "observations_count": 80807855,
          "parent_id": 372739,
          "preferred_common_name": "Insects",
          "rank": "class",
          "rank_level": 50,
          "taxon_changes_count": 3,
          "taxon_schemes_count": 2,
          "wikipedia_url": "http://en.wikipedia.org/wiki/Insect"
        },
        {
          "id": 184884,
          "ancestor_ids": [
            48460,
            1,
            47120,
            372739,
            47158,
            184884
          ],
          "ancestry": "48460/1/47120/372739/47158",
          "atlas_id": null,
          "complete_rank": "order",
          "complete_species_count": null,
          "current_synonymous_taxon_ids": null,
          "default_photo": {
            "id": 14350736,
            "attribution": "(c) Denis Doucet, some rights reserved (CC BY-NC), uploaded by Denis Doucet",
            "attribution_name": "Denis Doucet",
            "flags": [],
            "license_code": "cc-by-nc",
            "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/14350736/medium.jpg",
            "original_dimensions": {
              "height": 934,
              "width": 915
            },
            "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/14350736/square.jpg",
            "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/14350736/square.jpg"
          },
          "extinct": false,
          "provisional": false,
          "flag_counts": {
            "resolved": 5,
            "unresolved": 0
          },
          "iconic_taxon_id": 47158,
          "iconic_taxon_name": "Insecta",
          "is_active": true,
          "name": "Pterygota",
          "observations_count": 80461006,
          "parent_id": 47158,
          "preferred_common_name": "Winged and Once-winged Insects",
          "rank": "subclass",
          "rank_level": 47,
          "taxon_changes_count": 4,
          "taxon_schemes_count": 2,
          "wikipedia_url": "http://en.wikipedia.org/wiki/Pterygota"
        },
        {
          "id": 47208,
          "ancestor_ids": [
            48460,
            1,
            47120,
            372739,
            47158,
            184884,
            47208
          ],
          "ancestry": "48460/1/47120/372739/47158/184884",
          "atlas_id": null,
          "complete_species_count": null,
          "current_synonymous_taxon_ids": null,
          "default_photo": {
            "id": 15152305,
            "attribution": "(c) Wynand Uys, some rights reserved (CC BY), uploaded by Wynand Uys",
            "attribution_name": "Wynand Uys",
            "flags": [],
            "license_code": "cc-by",
            "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/15152305/medium.jpg",
            "original_dimensions": {
              "height": 595,
              "width": 800
            },
            "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/15152305/square.jpg",
            "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/15152305/square.jpg"
          },
          "extinct": false,
          "provisional": false,
          "flag_counts": {
            "resolved": 5,
            "unresolved": 1
          },
          "iconic_taxon_id": 47158,
          "iconic_taxon_name": "Insecta",
          "is_active": true,
          "name": "Coleoptera",
          "observations_count": 11106138,
          "parent_id": 184884,
          "preferred_common_name": "Beetles",
          "rank": "order",
          "rank_level": 40,
          "taxon_changes_count": 0,
          "taxon_schemes_count": 2,
          "wikipedia_url": "http://en.wikipedia.org/wiki/Beetle"
        },
        {
          "id": 71130,
          "ancestor_ids": [
            48460,
            1,
            47120,
            372739,
            47158,
            184884,
            47208,
            71130
          ],
          "ancestry": "48460/1/47120/372739/47158/184884/47208",
          "atlas_id": null,
          "complete_species_count": null,
          "current_synonymous_taxon_ids": null,
          "default_photo": {
            "id": 28165128,
            "attribution": "(c) Eduardo Axel Recillas Bautista, some rights reserved (CC BY-NC), uploaded by Eduardo Axel Recillas Bautista",
            "attribution_name": "Eduardo Axel Recillas Bautista",
            "flags": [],
            "license_code": "cc-by-nc",
            "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/28165128/medium.jpg",
            "original_dimensions": {
              "height": 550,
              "width": 800
            },
            "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/28165128/square.jpg",
            "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/28165128/square.jpg"
          },
          "extinct": false,
          "provisional": false,
          "flag_counts": {
            "resolved": 0,
            "unresolved": 0
          },
          "iconic_taxon_id": 47158,
          "iconic_taxon_name": "Insecta",
          "is_active": true,
          "name": "Polyphaga",
          "observations_count": 9949470,
          "parent_id": 47208,
          "preferred_common_name": "Water, Rove, Scarab, Long-horned, Leaf, and Snout Beetles",
          "rank": "suborder",
          "rank_level": 37,
          "taxon_changes_count": 0,
          "taxon_schemes_count": 1,
          "wikipedia_url": "http://en.wikipedia.org/wiki/Polyphaga"
        },
        {
          "id": 372870,
          "ancestor_ids": [
            48460,
            1,
            47120,
            372739,
            47158,
            184884,
            47208,
            71130,
            372870
          ],
          "ancestry": "48460/1/47120/372739/47158/184884/47208/71130",
          "atlas_id": null,
          "complete_species_count": null,
          "current_synonymous_taxon_ids": null,
          "default_photo": {
            "id": 14776949,
            "attribution": "(c) Pierre Bornand, some rights reserved (CC BY-NC)",
            "attribution_name": "Pierre Bornand",
            "flags": [],
            "license_code": "cc-by-nc",
            "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/14776949/medium.jpg",
            "original_dimensions": {
              "height": 1536,
              "width": 2048
            },
            "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/14776949/square.jpg",
            "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/14776949/square.jpg"
          },
          "extinct": false,
          "provisional": false,
          "flag_counts": {
            "resolved": 0,
            "unresolved": 0
          },
          "iconic_taxon_id": 47158,
          "iconic_taxon_name": "Insecta",
          "is_active": true,
          "name": "Staphyliniformia",
          "observations_count": 457109,
          "parent_id": 71130,
          "preferred_common_name": "Staphyliniform Beetles",
          "rank": "infraorder",
          "rank_level": 35,
          "taxon_changes_count": 0,
          "taxon_schemes_count": 2,
          "wikipedia_url": "http://en.wikipedia.org/wiki/Staphyliniformia"
        },
        {
          "id": 48311,
          "ancestor_ids": [
            48460,
            1,
            47120,
            372739,
            47158,
            184884,
            47208,
            71130,
            372870,
            48311
          ],
          "ancestry": "48460/1/47120/372739/47158/184884/47208/71130/372870",
          "atlas_id": null,
          "complete_species_count": null,
          "current_synonymous_taxon_ids": null,
          "default_photo": {
            "id": 19280441,
            "attribution": "(c) Isa Betancourt, some rights reserved (CC BY-NC-ND), uploaded by Isa Betancourt",
            "attribution_name": "Isa Betancourt",
            "flags": [],
            "license_code": "cc-by-nc-nd",
            "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/19280441/medium.jpg",
            "original_dimensions": {
              "height": 1365,
              "width": 2048
            },
            "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/19280441/square.jpg",
            "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/19280441/square.jpg"
          },
          "extinct": false,
          "provisional": false,
          "flag_counts": {
            "resolved": 1,
            "unresolved": 0
          },
          "iconic_taxon_id": 47158,
          "iconic_taxon_name": "Insecta",
          "is_active": true,
          "name": "Staphylinoidea",
          "observations_count": 380762,
          "parent_id": 372870,
          "preferred_common_name": "Rove, Ant-like stone, and Carrion Beetles",
          "rank": "superfamily",
          "rank_level": 33,
          "taxon_changes_count": 0,
          "taxon_schemes_count": 2,
          "wikipedia_url": "http://en.wikipedia.org/wiki/Staphylinoidea"
        },
        {
          "id": 47951,
          "ancestor_ids": [
            48460,
            1,
            47120,
            372739,
            47158,
            184884,
            47208,
            71130,
            372870,
            48311,
            47951
          ],
          "ancestry": "48460/1/47120/372739/47158/184884/47208/71130/372870/48311",
          "atlas_id": null,
          "complete_species_count": null,
          "current_synonymous_taxon_ids": null,
          "default_photo": {
            "id": 8130819,
            "attribution": "(c) Katja Schulz, some rights reserved (CC BY)",
            "attribution_name": "Katja Schulz",
            "flags": [],
            "license_code": "cc-by",
            "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/8130819/medium.jpg",
            "original_dimensions": {
              "height": 1535,
              "width": 2048
            },
            "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/8130819/square.jpg",
            "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/8130819/square.jpg"
          },
          "extinct": false,
          "provisional": false,
          "flag_counts": {
            "resolved": 12,
            "unresolved": 0
          },
          "iconic_taxon_id": 47158,
          "iconic_taxon_name": "Insecta",
          "is_active": true,
          "name": "Staphylinidae",
          "observations_count": 370695,
          "parent_id": 48311,
          "preferred_common_name": "Rove Beetles",
          "rank": "family",
          "rank_level": 30,
          "taxon_changes_count": 0,
          "taxon_schemes_count": 2,
          "wikipedia_url": "http://en.wikipedia.org/wiki/Rove_beetle"
        },
        {
          "id": 1642609,
          "ancestor_ids": [
            48460,
            1,
            47120,
            372739,
            47158,
            184884,
            47208,
            71130,
            372870,
            48311,
            47951,
            1642609
          ],
          "ancestry": "48460/1/47120/372739/47158/184884/47208/71130/372870/48311/47951",
          "atlas_id": null,
          "complete_species_count": null,
          "current_synonymous_taxon_ids": null,
          "default_photo": {
            "id": 569248697,
            "attribution": "(c) Francisco Welter-Schultes, some rights reserved (CC BY-NC), uploaded by Francisco Welter-Schultes",
            "attribution_name": "Francisco Welter-Schultes",
            "flags": [],
            "license_code": "cc-by-nc",
            "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/569248697/medium.jpg",
            "original_dimensions": {
              "height": 1496,
              "width": 2048
            },
            "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/569248697/square.jpg",
            "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/569248697/square.jpg"
          },
          "extinct": false,
          "provisional": false,
          "flag_counts": {
            "resolved": 0,
            "unresolved": 1
          },
          "iconic_taxon_id": 47158,
          "iconic_taxon_name": "Insecta",
          "is_active": true,
          "name": "Silphinae",
          "observations_count": 117984,
          "parent_id": 47951,
          "preferred_common_name": "Burying and Carrion Beetles",
          "rank": "subfamily",
          "rank_level": 27,
          "taxon_changes_count": 1,
          "taxon_schemes_count": 0,
          "wikipedia_url": "https://en.wikipedia.org/wiki/Silphinae"
        },
        {
          "id": 1642616,
          "ancestor_ids": [
            48460,
            1,
            47120,
            372739,
            47158,
            184884,
            47208,
            71130,
            372870,
            48311,
            47951,
            1642609,
            1642616
          ],
          "ancestry": "48460/1/47120/372739/47158/184884/47208/71130/372870/48311/47951/1642609",
          "atlas_id": null,
          "complete_species_count": null,
          "current_synonymous_taxon_ids": null,
          "default_photo": {
            "id": 48789439,
            "attribution": "(c) Anita Sprungk, some rights reserved (CC BY-NC), uploaded by Anita Sprungk",
            "attribution_name": "Anita Sprungk",
            "flags": [],
            "license_code": "cc-by-nc",
            "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/48789439/medium.jpeg",
            "original_dimensions": {
              "height": 1536,
              "width": 2048
            },
            "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/48789439/square.jpeg",
            "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/48789439/square.jpeg"
          },
          "extinct": false,
          "provisional": false,
          "flag_counts": {
            "resolved": 0,
            "unresolved": 0
          },
          "iconic_taxon_id": 47158,
          "iconic_taxon_name": "Insecta",
          "is_active": true,
          "name": "Nicrophorini",
          "observations_count": 41872,
          "parent_id": 1642609,
          "rank": "tribe",
          "rank_level": 25,
          "taxon_changes_count": 1,
          "taxon_schemes_count": 0,
          "wikipedia_url": "https://en.wikipedia.org/wiki/Nicrophorini"
        },
        {
          "id": 53850,
          "ancestor_ids": [
            48460,
            1,
            47120,
            372739,
            47158,
            184884,
            47208,
            71130,
            372870,
            48311,
            47951,
            1642609,
            1642616,
            53850
          ],
          "ancestry": "48460/1/47120/372739/47158/184884/47208/71130/372870/48311/47951/1642609/1642616",
          "atlas_id": null,
          "complete_species_count": null,
          "current_synonymous_taxon_ids": null,
          "default_photo": {
            "id": 24573164,
            "attribution": "(c) Nikolai Vladimirov, some rights reserved (CC BY-NC), uploaded by Nikolai Vladimirov",
            "attribution_name": "Nikolai Vladimirov",
            "flags": [],
            "license_code": "cc-by-nc",
            "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/24573164/medium.jpg",
            "original_dimensions": {
              "height": 1365,
              "width": 2048
            },
            "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/24573164/square.jpg",
            "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/24573164/square.jpg"
          },
          "extinct": false,
          "provisional": false,
          "flag_counts": {
            "resolved": 0,
            "unresolved": 0
          },
          "iconic_taxon_id": 47158,
          "iconic_taxon_name": "Insecta",
          "is_active": true,
          "name": "Nicrophorus",
          "observations_count": 41841,
          "parent_id": 1642616,
          "preferred_common_name": "Burying Beetles",
          "rank": "genus",
          "rank_level": 20,
          "taxon_changes_count": 0,
          "taxon_schemes_count": 1,
          "wikipedia_url": "http://en.wikipedia.org/wiki/Burying_beetle"
        }
      ],
      "ancestor_ids": [
        48460,
        1,
        47120,
        372739,
        47158,
        184884,
        47208,
        71130,
        372870,
        48311,
        47951,
        1642609,
        1642616,
        53850
      ],
      "ancestry": "48460/1/47120/372739/47158/184884/47208/71130/372870/48311/47951/1642609/1642616/53850",
      "atlas_id": null,
      "children": [
        {
          "id": 70114,
          "ancestor_ids": [
            48460,
            1,
            47120,
            372739,
            47158,
            184884,
            47208,
            71130,
            372870,
            48311,
            47951,
            1642609,
            1642616,
            53850,
            70118,
            70114
          ],
          "ancestry": "48460/1/47120/372739/47158/184884/47208/71130/372870/48311/47951/1642609/1642616/53850/70118",
          "atlas_id": null,
          "complete_species_count": null,
          "current_synonymous_taxon_ids": null,
          "default_photo": null,
          "extinct": false,
          "provisional": false,
          "flag_counts": {
            "resolved": 0,
            "unresolved": 0
          },
          "iconic_taxon_id": 47158,
          "iconic_taxon_name": "Insecta",
          "is_active": true,
          "name": "Nicrophorus vespilloides aurora",
          "observations_count": 0,
          "parent_id": 70118,
          "rank": "variety",
          "rank_level": 5,
          "taxon_changes_count": 0,
          "taxon_schemes_count": 1,
          "wikipedia_url": null
        },
        {
          "id": 70115,
          "ancestor_ids": [
            48460,
            1,
            47120,
            372739,
            47158,
            184884,
            47208,
            71130,
            372870,
            48311,
            47951,
            1642609,
            1642616,
            53850,
            70118,
            70115
          ],
          "ancestry": "48460/1/47120/372739/47158/184884/47208/71130/372870/48311/47951/1642609/1642616/53850/70118",
          "atlas_id": null,
          "complete_species_count": null,
          "current_synonymous_taxon_ids": null,
          "default_photo": null,
          "extinct": false,
          "provisional": false,
          "flag_counts": {
            "resolved": 0,
            "unresolved": 0
          },
          "iconic_taxon_id": 47158,
          "iconic_taxon_name": "Insecta",
          "is_active": true,
          "name": "Nicrophorus vespilloides altumi",
          "observations_count": 0,
          "parent_id": 70118,
          "rank": "form",
          "rank_level": 5,
          "taxon_changes_count": 0,
          "taxon_schemes_count": 1,
          "wikipedia_url": null
        },
        {
          "id": 70116,
          "ancestor_ids": [
            48460,
            1,
            47120,
            372739,
            47158,
            184884,
            47208,
            71130,
            372870,
            48311,
            47951,
            1642609,
            1642616,
            53850,
            70118,
            70116
          ],
          "ancestry": "48460/1/47120/372739/47158/184884/47208/71130/372870/48311/47951/1642609/1642616/53850/70118",
          "atlas_id": null,
          "complete_species_count": null,
          "current_synonymous_taxon_ids": null,
          "default_photo": null,
          "extinct": false,
          "provisional": false,
          "flag_counts": {
            "resolved": 0,
            "unresolved": 0
          },
          "iconic_taxon_id": 47158,
          "iconic_taxon_name": "Insecta",
          "is_active": true,
          "name": "Nicrophorus vespilloides sylvivagus",
          "observations_count": 0,
          "parent_id": 70118,
          "rank": "subspecies",
          "rank_level": 5,
          "taxon_changes_count": 0,
          "taxon_schemes_count": 1,
          "wikipedia_url": null
        },
        {
          "id": 70117,
          "ancestor_ids": [
            48460,
            1,
            47120,
            372739,
            47158,
            184884,
            47208,
            71130,
            372870,
            48311,
            47951,
            1642609,
            1642616,
            53850,
            70118,
            70117
          ],
          "ancestry": "48460/1/47120/372739/47158/184884/47208/71130/372870/48311/47951/1642609/1642616/53850/70118",
          "atlas_id": null,
          "complete_species_count": null,
          "current_synonymous_taxon_ids": null,
          "default_photo": null,
          "extinct": false,
          "provisional": false,
          "flag_counts": {
            "resolved": 0,
            "unresolved": 0
          },
          "iconic_taxon_id": 47158,
          "iconic_taxon_name": "Insecta",
          "is_active": true,
          "name": "Nicrophorus vespilloides subfasciatus",
          "observations_count": 0,
          "parent_id": 70118,
          "rank": "variety",
          "rank_level": 5,
          "taxon_changes_count": 0,
          "taxon_schemes_count": 1,
          "wikipedia_url": null
        }
      ],
      "complete_species_count": null,
      "conservation_status": null,
      "conservation_statuses": [
        {
          "id": 368634,
          "authority": "NatureServe",
          "description": null,
          "geoprivacy": "open",
          "iucn": 0,
          "place": {
            "id": 6712,
            "name": "Canada",
            "display_name": "Canada"
          },
          "source_id": null,
          "status": "NNR",
          "taxon_id": 70118,
          "url": "https://explorer.natureserve.org/Taxon/ELEMENT_GLOBAL.2.1279055"
        },
        {
          "id": 368635,
          "authority": "NatureServe",
          "description": null,
          "geoprivacy": "open",
          "iucn": 30,
          "place": {
            "id": 9079,
            "name": "Northwest Territories",
            "display_name": "Northwest Territories, CA"
          },
          "source_id": null,
          "status": "S3",
          "taxon_id": 70118,
          "url": "https://explorer.natureserve.org/Taxon/ELEMENT_GLOBAL.2.1279055"
        }
      ],
      "current_synonymous_taxon_ids": null,
      "default_photo": {
        "id": 38359335,
        "attribution": "(c) salvatore_infanti, some rights reserved (CC BY-NC), uploaded by salvatore_infanti",
        "attribution_name": "salvatore_infanti",
        "flags": [],
        "license_code": "cc-by-nc",
        "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/medium.jpg",
        "original_dimensions": {
          "height": 1365,
          "width": 2048
        },
        "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/square.jpg",
        "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/square.jpg"
      },
      "extinct": false,
      "provisional": false,
      "flag_counts": {
        "resolved": 0,
        "unresolved": 0
      },
      "iconic_taxon_id": 47158,
      "iconic_taxon_name": "Insecta",
      "is_active": true,
      "listed_taxa": [
        {
          "id": 8171118,
          "establishment_means": "native",
          "list": {
            "id": 313166,
            "title": "Europe Check List"
          },
          "taxon_id": 70118,
          "place": {
            "id": 97391,
            "admin_level": -10,
            "ancestor_place_ids": [
              97391
            ],
            "display_name": "Europe",
            "name": "Europe"
          }
        },
        {
          "id": 13567836,
          "establishment_means": "native",
          "list": {
            "id": 313169,
            "title": "North America Check List"
          },
          "taxon_id": 70118,
          "place": {
            "id": 97394,
            "admin_level": -10,
            "ancestor_place_ids": [
              97394
            ],
            "display_name": "North America",
            "name": "North America"
          }
        },
        {
          "id": 5680497,
          "establishment_means": "native",
          "list": {
            "id": 187791,
            "title": "NatureServe Canada"
          },
          "taxon_id": 70118,
          "place": {
            "id": 6712,
            "admin_level": 0,
            "ancestor_place_ids": [
              97394,
              6712
            ],
            "display_name": "Canada",
            "name": "Canada"
          }
        },
        {
          "id": 10817901,
          "establishment_means": "native",
          "list": {
            "id": 7069,
            "title": "France Check List"
          },
          "taxon_id": 70118,
          "place": {
            "id": 6753,
            "admin_level": 0,
            "ancestor_place_ids": [
              97391,
              6753
            ],
            "display_name": "France",
            "name": "France"
          }
        },
        {
          "id": 5577060,
          "establishment_means": "native",
          "list": {
            "id": 299,
            "title": "United States Check List"
          },
          "taxon_id": 70118,
          "place": {
            "id": 1,
            "admin_level": 0,
            "ancestor_place_ids": [
              97394,
              1
            ],
            "display_name": "United States",
            "name": "United States"
          }
        },
        {
          "id": 126220549,
          "establishment_means": "native",
          "list": {
            "id": 9856,
            "title": "Northwest Territories Check List"
          },
          "taxon_id": 70118,
          "place": {
            "id": 9079,
            "admin_level": 10,
            "ancestor_place_ids": [
              97394,
              6712,
              9079
            ],
            "display_name": "Northwest Territories, CA",
            "name": "Northwest Territories"
          }
        },
        {
          "id": 5577061,
          "establishment_means": "native",
          "list": {
            "id": 304,
            "title": "Alaska Check List"
          },
          "taxon_id": 70118,
          "place": {
            "id": 6,
            "admin_level": 10,
            "ancestor_place_ids": [
              97394,
              1,
              6
            ],
            "display_name": "Alaska, US",
            "name": "Alaska"
          }
        },
        {
          "id": 22492647,
          "establishment_means": "native",
          "list": {
            "id": 13342,
            "title": "Pays de la Loire Check List"
          },
          "taxon_id": 70118,
          "place": {
            "id": 10581,
            "admin_level": 10,
            "ancestor_place_ids": [
              97391,
              6753,
              10581
            ],
            "display_name": "Pays de la Loire, FR",
            "name": "Pays de la Loire"
          }
        },
        {
          "id": 22492648,
          "establishment_means": "native",
          "list": {
            "id": 32972,
            "title": "Vend\u00e9e Check List"
          },
          "taxon_id": 70118,
          "place": {
            "id": 30209,
            "admin_level": 20,
            "ancestor_place_ids": [
              97391,
              6753,
              10581,
              30209
            ],
            "display_name": "Vend\u00e9e, Pays de la Loire, FR",
            "name": "Vend\u00e9e"
          }
        },
        {
          "id": 5577062,
          "establishment_means": "native",
          "list": {
            "id": 639,
            "title": "Kenai Peninsula Borough Check List"
          },
          "taxon_id": 70118,
          "place": {
            "id": 341,
            "admin_level": 20,
            "ancestor_place_ids": [
              97394,
              1,
              6,
              341
            ],
            "display_name": "Kenai Peninsula County, US, AK",
            "name": "Kenai Peninsula"
          }
        }
      ],
      "listed_taxa_count": 10,
      "name": "Nicrophorus vespilloides",
      "observations_count": 5996,
      "parent_id": 53850,
      "photos_locked": false,
      "preferred_common_name": "Lesser Vespillo Burying Beetle",
      "rank": "species",
      "rank_level": 10,
      "taxon_changes_count": 0,
      "taxon_photos": [
        {
          "taxon": {
            "id": 70118,
            "ancestor_ids": [
              48460,
              1,
              47120,
              372739,
              47158,
              184884,
              47208,
              71130,
              372870,
              48311,
              47951,
              1642609,
              1642616,
              53850,
              70118
            ],
            "ancestry": "48460/1/47120/372739/47158/184884/47208/71130/372870/48311/47951/1642609/1642616/53850",
            "atlas_id": null,
            "complete_species_count": null,
            "current_synonymous_taxon_ids": null,
            "default_photo": {
              "id": 38359335,
              "attribution": "(c) salvatore_infanti, some rights reserved (CC BY-NC), uploaded by salvatore_infanti",
              "attribution_name": "salvatore_infanti",
              "flags": [],
              "license_code": "cc-by-nc",
              "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/medium.jpg",
              "original_dimensions": {
                "height": 1365,
                "width": 2048
              },
              "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/square.jpg",
              "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/square.jpg"
            },
            "extinct": false,
            "provisional": false,
            "flag_counts": {
              "resolved": 0,
              "unresolved": 0
            },
            "iconic_taxon_id": 47158,
            "iconic_taxon_name": "Insecta",
            "is_active": true,
            "name": "Nicrophorus vespilloides",
            "observations_count": 5996,
            "parent_id": 53850,
            "photos_locked": false,
            "preferred_common_name": "Lesser Vespillo Burying Beetle",
            "rank": "species",
            "rank_level": 10,
            "taxon_changes_count": 0,
            "taxon_schemes_count": 2,
            "wikipedia_url": "http://en.wikipedia.org/wiki/Nicrophorus_vespilloides"
          },
          "taxon_id": 70118,
          "photo": {
            "id": 38359335,
            "attribution": "(c) salvatore_infanti, some rights reserved (CC BY-NC), uploaded by salvatore_infanti",
            "attribution_name": "salvatore_infanti",
            "flags": [],
            "large_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/large.jpg",
            "license_code": "cc-by-nc",
            "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/medium.jpg",
            "native_page_url": null,
            "native_photo_id": null,
            "original_dimensions": {
              "height": 1365,
              "width": 2048
            },
            "original_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/original.jpg",
            "small_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/small.jpg",
            "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/square.jpg",
            "type": "LocalPhoto",
            "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/square.jpg"
          }
        },
        {
          "taxon": {
            "id": 70118,
            "ancestor_ids": [
              48460,
              1,
              47120,
              372739,
              47158,
              184884,
              47208,
              71130,
              372870,
              48311,
              47951,
              1642609,
              1642616,
              53850,
              70118
            ],
            "ancestry": "48460/1/47120/372739/47158/184884/47208/71130/372870/48311/47951/1642609/1642616/53850",
            "atlas_id": null,
            "complete_species_count": null,
            "current_synonymous_taxon_ids": null,
            "default_photo": {
              "id": 38359335,
              "attribution": "(c) salvatore_infanti, some rights reserved (CC BY-NC), uploaded by salvatore_infanti",
              "attribution_name": "salvatore_infanti",
              "flags": [],
              "license_code": "cc-by-nc",
              "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/medium.jpg",
              "original_dimensions": {
                "height": 1365,
                "width": 2048
              },
              "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/square.jpg",
              "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/square.jpg"
            },
            "extinct": false,
            "provisional": false,
            "flag_counts": {
              "resolved": 0,
              "unresolved": 0
            },
            "iconic_taxon_id": 47158,
            "iconic_taxon_name": "Insecta",
            "is_active": true,
            "name": "Nicrophorus vespilloides",
            "observations_count": 5996,
            "parent_id": 53850,
            "photos_locked": false,
            "preferred_common_name": "Lesser Vespillo Burying Beetle",
            "rank": "species",
            "rank_level": 10,
            "taxon_changes_count": 0,
            "taxon_schemes_count": 2,
            "wikipedia_url": "http://en.wikipedia.org/wiki/Nicrophorus_vespilloides"
          },
          "taxon_id": 70118,
          "photo": {
            "id": 28005460,
            "attribution": "(c) Jorma Kortelainen, all rights reserved, uploaded by Jorma Kortelainen",
            "attribution_name": "Jorma Kortelainen",
            "flags": [],
            "large_url": "https://static.inaturalist.org/photos/28005460/large.jpg",
            "license_code": null,
            "medium_url": "https://static.inaturalist.org/photos/28005460/medium.jpg",
            "native_page_url": null,
            "native_photo_id": null,
            "original_dimensions": {
              "height": 2048,
              "width": 2048
            },
            "original_url": "https://static.inaturalist.org/photos/28005460/original.jpg",
            "small_url": "https://static.inaturalist.org/photos/28005460/small.jpg",
            "square_url": "https://static.inaturalist.org/photos/28005460/square.jpg",
            "type": "LocalPhoto",
            "url": "https://static.inaturalist.org/photos/28005460/square.jpg"
          }
        },
        {
          "taxon": {
            "id": 70118,
            "ancestor_ids": [
              48460,
              1,
              47120,
              372739,
              47158,
              184884,
              47208,
              71130,
              372870,
              48311,
              47951,
              1642609,
              1642616,
              53850,
              70118
            ],
            "ancestry": "48460/1/47120/372739/47158/184884/47208/71130/372870/48311/47951/1642609/1642616/53850",
            "atlas_id": null,
            "complete_species_count": null,
            "current_synonymous_taxon_ids": null,
            "default_photo": {
              "id": 38359335,
              "attribution": "(c) salvatore_infanti, some rights reserved (CC BY-NC), uploaded by salvatore_infanti",
              "attribution_name": "salvatore_infanti",
              "flags": [],
              "license_code": "cc-by-nc",
              "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/medium.jpg",
              "original_dimensions": {
                "height": 1365,
                "width": 2048
              },
              "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/square.jpg",
              "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/square.jpg"
            },
            "extinct": false,
            "provisional": false,
            "flag_counts": {
              "resolved": 0,
              "unresolved": 0
            },
            "iconic_taxon_id": 47158,
            "iconic_taxon_name": "Insecta",
            "is_active": true,
            "name": "Nicrophorus vespilloides",
            "observations_count": 5996,
            "parent_id": 53850,
            "photos_locked": false,
            "preferred_common_name": "Lesser Vespillo Burying Beetle",
            "rank": "species",
            "rank_level": 10,
            "taxon_changes_count": 0,
            "taxon_schemes_count": 2,
            "wikipedia_url": "http://en.wikipedia.org/wiki/Nicrophorus_vespilloides"
          },
          "taxon_id": 70118,
          "photo": {
            "id": 75367590,
            "attribution": "(c) \u041c\u0430\u0440\u0438\u043d\u0430 \u0413\u043e\u0440\u0431\u0443\u043d\u043e\u0432\u0430-\u00cb\u043b\u043a\u0438\u043d\u0430, some rights reserved (CC BY-NC), uploaded by \u041c\u0430\u0440\u0438\u043d\u0430 \u0413\u043e\u0440\u0431\u0443\u043d\u043e\u0432\u0430-\u00cb\u043b\u043a\u0438\u043d\u0430",
            "attribution_name": "\u041c\u0430\u0440\u0438\u043d\u0430 \u0413\u043e\u0440\u0431\u0443\u043d\u043e\u0432\u0430-\u00cb\u043b\u043a\u0438\u043d\u0430",
            "flags": [],
            "large_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/75367590/large.jpg",
            "license_code": "cc-by-nc",
            "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/75367590/medium.jpg",
            "native_page_url": null,
            "native_photo_id": null,
            "original_dimensions": {
              "height": 1367,
              "width": 2048
            },
            "original_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/75367590/original.jpg",
            "small_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/75367590/small.jpg",
            "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/75367590/square.jpg",
            "type": "LocalPhoto",
            "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/75367590/square.jpg"
          }
        },
        {
          "taxon": {
            "id": 70118,
            "ancestor_ids": [
              48460,
              1,
              47120,
              372739,
              47158,
              184884,
              47208,
              71130,
              372870,
              48311,
              47951,
              1642609,
              1642616,
              53850,
              70118
            ],
            "ancestry": "48460/1/47120/372739/47158/184884/47208/71130/372870/48311/47951/1642609/1642616/53850",
            "atlas_id": null,
            "complete_species_count": null,
            "current_synonymous_taxon_ids": null,
            "default_photo": {
              "id": 38359335,
              "attribution": "(c) salvatore_infanti, some rights reserved (CC BY-NC), uploaded by salvatore_infanti",
              "attribution_name": "salvatore_infanti",
              "flags": [],
              "license_code": "cc-by-nc",
              "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/medium.jpg",
              "original_dimensions": {
                "height": 1365,
                "width": 2048
              },
              "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/square.jpg",
              "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/square.jpg"
            },
            "extinct": false,
            "provisional": false,
            "flag_counts": {
              "resolved": 0,
              "unresolved": 0
            },
            "iconic_taxon_id": 47158,
            "iconic_taxon_name": "Insecta",
            "is_active": true,
            "name": "Nicrophorus vespilloides",
            "observations_count": 5996,
            "parent_id": 53850,
            "photos_locked": false,
            "preferred_common_name": "Lesser Vespillo Burying Beetle",
            "rank": "species",
            "rank_level": 10,
            "taxon_changes_count": 0,
            "taxon_schemes_count": 2,
            "wikipedia_url": "http://en.wikipedia.org/wiki/Nicrophorus_vespilloides"
          },
          "taxon_id": 70118,
          "photo": {
            "id": 51162737,
            "attribution": "(c) Suso Tiz\u00f3n, some rights reserved (CC BY-NC-SA), uploaded by Suso Tiz\u00f3n",
            "attribution_name": "Suso Tiz\u00f3n",
            "flags": [],
            "large_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/51162737/large.jpeg",
            "license_code": "cc-by-nc-sa",
            "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/51162737/medium.jpeg",
            "native_page_url": null,
            "native_photo_id": null,
            "original_dimensions": {
              "height": 1365,
              "width": 2048
            },
            "original_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/51162737/original.jpeg",
            "small_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/51162737/small.jpeg",
            "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/51162737/square.jpeg",
            "type": "LocalPhoto",
            "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/51162737/square.jpeg"
          }
        },
        {
          "taxon": {
            "id": 70118,
            "ancestor_ids": [
              48460,
              1,
              47120,
              372739,
              47158,
              184884,
              47208,
              71130,
              372870,
              48311,
              47951,
              1642609,
              1642616,
              53850,
              70118
            ],
            "ancestry": "48460/1/47120/372739/47158/184884/47208/71130/372870/48311/47951/1642609/1642616/53850",
            "atlas_id": null,
            "complete_species_count": null,
            "current_synonymous_taxon_ids": null,
            "default_photo": {
              "id": 38359335,
              "attribution": "(c) salvatore_infanti, some rights reserved (CC BY-NC), uploaded by salvatore_infanti",
              "attribution_name": "salvatore_infanti",
              "flags": [],
              "license_code": "cc-by-nc",
              "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/medium.jpg",
              "original_dimensions": {
                "height": 1365,
                "width": 2048
              },
              "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/square.jpg",
              "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/38359335/square.jpg"
            },
            "extinct": false,
            "provisional": false,
            "flag_counts": {
              "resolved": 0,
              "unresolved": 0
            },
            "iconic_taxon_id": 47158,
            "iconic_taxon_name": "Insecta",
            "is_active": true,
            "name": "Nicrophorus vespilloides",
            "observations_count": 5996,
            "parent_id": 53850,
            "photos_locked": false,
            "preferred_common_name": "Lesser Vespillo Burying Beetle",
            "rank": "species",
            "rank_level": 10,
            "taxon_changes_count": 0,
            "taxon_schemes_count": 2,
            "wikipedia_url": "http://en.wikipedia.org/wiki/Nicrophorus_vespilloides"
          },
          "taxon_id": 70118,
          "photo": {
            "id": 11085978,
            "attribution": "(c) Tony Palmer, some rights reserved (CC BY-NC), uploaded by Tony Palmer",
            "attribution_name": "Tony Palmer",
            "flags": [],
            "large_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/11085978/large.jpg",
            "license_code": "cc-by-nc",
            "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/11085978/medium.jpg",
            "native_page_url": null,
            "native_photo_id": null,
            "original_dimensions": {
              "height": 1224,
              "width": 1313
            },
            "original_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/11085978/original.jpg",
            "small_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/11085978/small.jpg",
            "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/11085978/square.jpg",
            "type": "LocalPhoto",
            "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/11085978/square.jpg"
          }
        }
      ],
      "taxon_schemes_count": 2,
      "vision": true,
      "wikipedia_summary": "<i><b>Nicrophorus vespilloides</b></i> is a burying beetle described by Johann Friedrich Wilhelm Herbst in 1783.",
      "wikipedia_url": "https://en.wikipedia.org/wiki/Nicrophorus vespilloides"
    }
  ]
}

Parameters:

taxon_id (int | Iterable[int]) – Get taxon with this ID. Multiple values are allowed.

Return type:

dict[str, Any]

Returns:

Response dict containing taxon records

pyinaturalist.v2.taxa.get_taxa_iconic(**params) → dict[str, Any]

Get all iconic taxa

Notes

• API reference: GET /taxa/iconic

Example

>>> response = get_taxa_iconic(fields='all')

Example Response (all fields)

{
  "total_results": 13,
  "page": 1,
  "per_page": 30,
  "results": [
    {
      "id": 1,
      "ancestor_ids": [
        48460,
        1
      ],
      "ancestry": "48460",
      "atlas_id": null,
      "complete_rank": "order",
      "complete_species_count": null,
      "current_synonymous_taxon_ids": null,
      "default_photo": {
        "id": 80678745,
        "attribution": "no rights reserved, uploaded by Abhas Misraraj",
        "attribution_name": "Abhas Misraraj",
        "flags": [],
        "license_code": "cc0",
        "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/80678745/medium.jpg",
        "original_dimensions": {
          "height": 2000,
          "width": 2000
        },
        "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/80678745/square.jpg",
        "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/80678745/square.jpg"
      },
      "extinct": false,
      "provisional": false,
      "flag_counts": {
        "resolved": 16,
        "unresolved": 1
      },
      "iconic_taxon_id": 1,
      "iconic_taxon_name": "Animalia",
      "is_active": true,
      "name": "Animalia",
      "observations_count": 166795722,
      "parent_id": 48460,
      "preferred_common_name": "Animals",
      "rank": "kingdom",
      "rank_level": 70,
      "taxon_changes_count": 7,
      "taxon_schemes_count": 2,
      "wikipedia_url": "http://en.wikipedia.org/wiki/Animal"
    },
    {
      "id": 47126,
      "ancestor_ids": [
        48460,
        47126
      ],
      "ancestry": "48460",
      "atlas_id": null,
      "complete_rank": "phylum",
      "complete_species_count": null,
      "current_synonymous_taxon_ids": null,
      "default_photo": {
        "id": 221143410,
        "attribution": "(c) Roc\u00edo Ram\u00edrez Barrios, all rights reserved, uploaded by Roc\u00edo Ram\u00edrez Barrios",
        "attribution_name": "Roc\u00edo Ram\u00edrez Barrios",
        "flags": [],
        "license_code": null,
        "medium_url": "https://static.inaturalist.org/photos/221143410/medium.jpeg",
        "original_dimensions": {
          "height": 2048,
          "width": 1462
        },
        "square_url": "https://static.inaturalist.org/photos/221143410/square.jpeg",
        "url": "https://static.inaturalist.org/photos/221143410/square.jpeg"
      },
      "extinct": false,
      "provisional": false,
      "flag_counts": {
        "resolved": 29,
        "unresolved": 2
      },
      "iconic_taxon_id": 47126,
      "iconic_taxon_name": "Plantae",
      "is_active": true,
      "name": "Plantae",
      "observations_count": 133818078,
      "parent_id": 48460,
      "preferred_common_name": "Plants",
      "rank": "kingdom",
      "rank_level": 70,
      "taxon_changes_count": 8,
      "taxon_schemes_count": 2,
      "wikipedia_url": "https://en.wikipedia.org/wiki/Plant"
    },
    {
      "id": 47158,
      "ancestor_ids": [
        48460,
        1,
        47120,
        372739,
        47158
      ],
      "ancestry": "48460/1/47120/372739",
      "atlas_id": null,
      "complete_rank": "order",
      "complete_species_count": null,
      "current_synonymous_taxon_ids": null,
      "default_photo": {
        "id": 18333696,
        "attribution": "(c) TOUROULT Julien, some rights reserved (CC BY), uploaded by TOUROULT Julien",
        "attribution_name": "TOUROULT Julien",
        "flags": [],
        "license_code": "cc-by",
        "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/18333696/medium.jpeg",
        "original_dimensions": {
          "height": 1357,
          "width": 2048
        },
        "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/18333696/square.jpeg",
        "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/18333696/square.jpeg"
      },
      "extinct": false,
      "provisional": false,
      "flag_counts": {
        "resolved": 44,
        "unresolved": 0
      },
      "iconic_taxon_id": 47158,
      "iconic_taxon_name": "Insecta",
      "is_active": true,
      "name": "Insecta",
      "observations_count": 80807855,
      "parent_id": 372739,
      "preferred_common_name": "Insects",
      "rank": "class",
      "rank_level": 50,
      "taxon_changes_count": 3,
      "taxon_schemes_count": 2,
      "wikipedia_url": "http://en.wikipedia.org/wiki/Insect"
    },
    {
      "id": 3,
      "ancestor_ids": [
        48460,
        1,
        2,
        355675,
        3
      ],
      "ancestry": "48460/1/2/355675",
      "atlas_id": null,
      "complete_rank": "subspecies",
      "complete_species_count": 10995,
      "current_synonymous_taxon_ids": null,
      "default_photo": {
        "id": 2967053,
        "attribution": "(c) Greg Lasley, some rights reserved (CC BY-NC), uploaded by Greg Lasley",
        "attribution_name": "Greg Lasley",
        "flags": [],
        "license_code": "cc-by-nc",
        "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/2967053/medium.jpg",
        "original_dimensions": {
          "height": 1333,
          "width": 2000
        },
        "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/2967053/square.jpg",
        "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/2967053/square.jpg"
      },
      "extinct": false,
      "provisional": false,
      "flag_counts": {
        "resolved": 21,
        "unresolved": 2
      },
      "iconic_taxon_id": 3,
      "iconic_taxon_name": "Aves",
      "is_active": true,
      "name": "Aves",
      "observations_count": 44324075,
      "parent_id": 355675,
      "preferred_common_name": "Birds",
      "rank": "class",
      "rank_level": 50,
      "taxon_changes_count": 4,
      "taxon_schemes_count": 2,
      "wikipedia_url": "http://en.wikipedia.org/wiki/Bird"
    },
    {
      "id": 47170,
      "ancestor_ids": [
        48460,
        47170
      ],
      "ancestry": "48460",
      "atlas_id": null,
      "complete_rank": "phylum",
      "complete_species_count": null,
      "current_synonymous_taxon_ids": null,
      "default_photo": {
        "id": 260296784,
        "attribution": "(c) Cho Fungi, some rights reserved (CC BY-NC), uploaded by Cho Fungi",
        "attribution_name": "Cho Fungi",
        "flags": [],
        "license_code": "cc-by-nc",
        "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/260296784/medium.jpg",
        "original_dimensions": {
          "height": 1984,
          "width": 1587
        },
        "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/260296784/square.jpg",
        "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/260296784/square.jpg"
      },
      "extinct": false,
      "provisional": false,
      "flag_counts": {
        "resolved": 56,
        "unresolved": 0
      },
      "iconic_taxon_id": 47170,
      "iconic_taxon_name": "Fungi",
      "is_active": true,
      "name": "Fungi",
      "observations_count": 19197691,
      "parent_id": 48460,
      "preferred_common_name": "Fungi Including Lichens",
      "rank": "kingdom",
      "rank_level": 70,
      "taxon_changes_count": 6,
      "taxon_schemes_count": 2,
      "wikipedia_url": "http://en.wikipedia.org/wiki/Fungus"
    },
    {
      "id": 47119,
      "ancestor_ids": [
        48460,
        1,
        47120,
        245097,
        47119
      ],
      "ancestry": "48460/1/47120/245097",
      "atlas_id": null,
      "complete_rank": "order",
      "complete_species_count": null,
      "current_synonymous_taxon_ids": null,
      "default_photo": {
        "id": 67339865,
        "attribution": "(c) harshithjv, some rights reserved (CC BY-NC-SA), uploaded by harshithjv",
        "attribution_name": "harshithjv",
        "flags": [],
        "license_code": "cc-by-nc-sa",
        "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/67339865/medium.jpeg",
        "original_dimensions": {
          "height": 1365,
          "width": 2048
        },
        "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/67339865/square.jpeg",
        "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/67339865/square.jpeg"
      },
      "extinct": false,
      "provisional": false,
      "flag_counts": {
        "resolved": 3,
        "unresolved": 0
      },
      "iconic_taxon_id": 47119,
      "iconic_taxon_name": "Arachnida",
      "is_active": true,
      "name": "Arachnida",
      "observations_count": 9015353,
      "parent_id": 245097,
      "preferred_common_name": "Arachnids",
      "rank": "class",
      "rank_level": 50,
      "taxon_changes_count": 1,
      "taxon_schemes_count": 2,
      "wikipedia_url": "http://en.wikipedia.org/wiki/Arachnid"
    },
    {
      "id": 40151,
      "ancestor_ids": [
        48460,
        1,
        2,
        355675,
        40151
      ],
      "ancestry": "48460/1/2/355675",
      "atlas_id": null,
      "complete_rank": "species",
      "complete_species_count": 6685,
      "current_synonymous_taxon_ids": null,
      "default_photo": {
        "id": 80551250,
        "attribution": "no rights reserved, uploaded by Abhas Misraraj",
        "attribution_name": "Abhas Misraraj",
        "flags": [],
        "license_code": "cc0",
        "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/80551250/medium.jpg",
        "original_dimensions": {
          "height": 2000,
          "width": 2000
        },
        "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/80551250/square.jpg",
        "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/80551250/square.jpg"
      },
      "extinct": false,
      "provisional": false,
      "flag_counts": {
        "resolved": 3,
        "unresolved": 1
      },
      "iconic_taxon_id": 40151,
      "iconic_taxon_name": "Mammalia",
      "is_active": true,
      "name": "Mammalia",
      "observations_count": 7343432,
      "parent_id": 355675,
      "preferred_common_name": "Mammals",
      "rank": "class",
      "rank_level": 50,
      "taxon_changes_count": 1,
      "taxon_schemes_count": 2,
      "wikipedia_url": "http://en.wikipedia.org/wiki/Mammal"
    },
    {
      "id": 26036,
      "ancestor_ids": [
        48460,
        1,
        2,
        355675,
        26036
      ],
      "ancestry": "48460/1/2/355675",
      "atlas_id": null,
      "complete_rank": "subspecies",
      "complete_species_count": 12265,
      "current_synonymous_taxon_ids": null,
      "default_photo": {
        "id": 29214589,
        "attribution": "(c) Matthieu Berroneau, all rights reserved",
        "attribution_name": "Matthieu Berroneau",
        "flags": [],
        "license_code": null,
        "medium_url": "https://static.inaturalist.org/photos/29214589/medium.jpg",
        "original_dimensions": {
          "height": 1133,
          "width": 1700
        },
        "square_url": "https://static.inaturalist.org/photos/29214589/square.jpg",
        "url": "https://static.inaturalist.org/photos/29214589/square.jpg"
      },
      "extinct": false,
      "provisional": false,
      "flag_counts": {
        "resolved": 6,
        "unresolved": 0
      },
      "iconic_taxon_id": 26036,
      "iconic_taxon_name": "Reptilia",
      "is_active": true,
      "name": "Reptilia",
      "observations_count": 6497074,
      "parent_id": 355675,
      "preferred_common_name": "Reptiles",
      "rank": "class",
      "rank_level": 50,
      "taxon_changes_count": 0,
      "taxon_schemes_count": 2,
      "wikipedia_url": "http://en.wikipedia.org/wiki/Reptile"
    },
    {
      "id": 47115,
      "ancestor_ids": [
        48460,
        1,
        47115
      ],
      "ancestry": "48460/1",
      "atlas_id": null,
      "complete_rank": "order",
      "complete_species_count": null,
      "current_synonymous_taxon_ids": null,
      "default_photo": {
        "id": 58051104,
        "attribution": "(c) Ian Shaw, all rights reserved, uploaded by Ian Shaw",
        "attribution_name": "Ian Shaw",
        "flags": [],
        "license_code": null,
        "medium_url": "https://static.inaturalist.org/photos/58051104/medium.jpg",
        "original_dimensions": {
          "height": 1200,
          "width": 1800
        },
        "square_url": "https://static.inaturalist.org/photos/58051104/square.jpg",
        "url": "https://static.inaturalist.org/photos/58051104/square.jpg"
      },
      "extinct": false,
      "provisional": false,
      "flag_counts": {
        "resolved": 7,
        "unresolved": 0
      },
      "iconic_taxon_id": 47115,
      "iconic_taxon_name": "Mollusca",
      "is_active": true,
      "name": "Mollusca",
      "observations_count": 4948912,
      "parent_id": 1,
      "preferred_common_name": "Molluscs",
      "rank": "phylum",
      "rank_level": 60,
      "taxon_changes_count": 2,
      "taxon_schemes_count": 2,
      "wikipedia_url": "http://en.wikipedia.org/wiki/Mollusca"
    },
    {
      "id": 20978,
      "ancestor_ids": [
        48460,
        1,
        2,
        355675,
        20978
      ],
      "ancestry": "48460/1/2/355675",
      "atlas_id": null,
      "complete_rank": "species",
      "complete_species_count": 8906,
      "current_synonymous_taxon_ids": null,
      "default_photo": {
        "id": 20797296,
        "attribution": "(c) Andr\u00e9s Mauricio Forero Cano, all rights reserved, uploaded by Andr\u00e9s Mauricio Forero Cano",
        "attribution_name": "Andr\u00e9s Mauricio Forero Cano",
        "flags": [],
        "license_code": null,
        "medium_url": "https://static.inaturalist.org/photos/20797296/medium.jpg",
        "original_dimensions": {
          "height": 1333,
          "width": 2000
        },
        "square_url": "https://static.inaturalist.org/photos/20797296/square.jpg",
        "url": "https://static.inaturalist.org/photos/20797296/square.jpg"
      },
      "extinct": false,
      "provisional": false,
      "flag_counts": {
        "resolved": 3,
        "unresolved": 0
      },
      "iconic_taxon_id": 20978,
      "iconic_taxon_name": "Amphibia",
      "is_active": true,
      "name": "Amphibia",
      "observations_count": 4019668,
      "parent_id": 355675,
      "preferred_common_name": "Amphibians",
      "rank": "class",
      "rank_level": 50,
      "taxon_changes_count": 0,
      "taxon_schemes_count": 2,
      "wikipedia_url": "http://en.wikipedia.org/wiki/Amphibian"
    },
    {
      "id": 47178,
      "ancestor_ids": [
        48460,
        1,
        2,
        355675,
        47178
      ],
      "ancestry": "48460/1/2/355675",
      "atlas_id": null,
      "complete_rank": "species",
      "complete_species_count": 35599,
      "current_synonymous_taxon_ids": null,
      "default_photo": {
        "id": 252526503,
        "attribution": "(c) uwkwaj, some rights reserved (CC BY-NC), uploaded by uwkwaj",
        "attribution_name": "uwkwaj",
        "flags": [],
        "license_code": "cc-by-nc",
        "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/252526503/medium.jpg",
        "original_dimensions": {
          "height": 903,
          "width": 1200
        },
        "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/252526503/square.jpg",
        "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/252526503/square.jpg"
      },
      "extinct": false,
      "provisional": false,
      "flag_counts": {
        "resolved": 8,
        "unresolved": 1
      },
      "iconic_taxon_id": 47178,
      "iconic_taxon_name": "Actinopterygii",
      "is_active": true,
      "name": "Actinopterygii",
      "observations_count": 3754966,
      "parent_id": 355675,
      "preferred_common_name": "Ray-finned Fishes",
      "rank": "class",
      "rank_level": 50,
      "taxon_changes_count": 1,
      "taxon_schemes_count": 2,
      "wikipedia_url": "http://en.wikipedia.org/wiki/Actinopterygii"
    },
    {
      "id": 47686,
      "ancestor_ids": [
        48460,
        47686
      ],
      "ancestry": "48460",
      "atlas_id": null,
      "complete_rank": "phylum",
      "complete_species_count": null,
      "current_synonymous_taxon_ids": null,
      "default_photo": {
        "id": 28906584,
        "attribution": "(c) \u0418\u0432\u0430\u043d \u041c\u0430\u0442\u0435\u0440\u0448\u0435\u0432, some rights reserved (CC BY-NC), uploaded by \u0418\u0432\u0430\u043d \u041c\u0430\u0442\u0435\u0440\u0448\u0435\u0432",
        "attribution_name": "\u0418\u0432\u0430\u043d \u041c\u0430\u0442\u0435\u0440\u0448\u0435\u0432",
        "flags": [],
        "license_code": "cc-by-nc",
        "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/28906584/medium.jpg",
        "original_dimensions": {
          "height": 1500,
          "width": 2000
        },
        "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/28906584/square.jpg",
        "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/28906584/square.jpg"
      },
      "extinct": false,
      "provisional": false,
      "flag_counts": {
        "resolved": 7,
        "unresolved": 0
      },
      "iconic_taxon_id": 47686,
      "iconic_taxon_name": "Protozoa",
      "is_active": true,
      "name": "Protozoa",
      "observations_count": 477132,
      "parent_id": 48460,
      "preferred_common_name": "protozoans",
      "rank": "kingdom",
      "rank_level": 70,
      "taxon_changes_count": 6,
      "taxon_schemes_count": 2,
      "wikipedia_url": "https://en.wikipedia.org/wiki/Protozoa"
    },
    {
      "id": 48222,
      "ancestor_ids": [
        48460,
        48222
      ],
      "ancestry": "48460",
      "atlas_id": null,
      "complete_rank": "phylum",
      "complete_species_count": null,
      "current_synonymous_taxon_ids": null,
      "default_photo": {
        "id": 131300,
        "attribution": "(c) NOAA's National Ocean Service, some rights reserved (CC BY-SA)",
        "attribution_name": "NOAA's National Ocean Service",
        "flags": [],
        "license_code": "cc-by-sa",
        "medium_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/131300/medium.jpg",
        "original_dimensions": {
          "height": 2048,
          "width": 1362
        },
        "square_url": "https://inaturalist-open-data.s3.amazonaws.com/photos/131300/square.jpg",
        "url": "https://inaturalist-open-data.s3.amazonaws.com/photos/131300/square.jpg"
      },
      "extinct": false,
      "provisional": false,
      "flag_counts": {
        "resolved": 1,
        "unresolved": 0
      },
      "iconic_taxon_id": 48222,
      "iconic_taxon_name": "Chromista",
      "is_active": true,
      "name": "Chromista",
      "observations_count": 439379,
      "parent_id": 48460,
      "preferred_common_name": "kelp, diatoms, and allies",
      "rank": "kingdom",
      "rank_level": 70,
      "taxon_changes_count": 1,
      "taxon_schemes_count": 2,
      "wikipedia_url": "http://en.wikipedia.org/wiki/Chromista"
    }
  ]
}

Return type:

dict[str, Any]

Returns:

Response dict containing iconic taxon records