ListedTaxon#
- class pyinaturalist.models.ListedTaxon(id=None, establishment_means=None, establishment_means_description=None, place=None, comments_count=0, created_at=None, description=None, first_observation_id=None, last_observation_id=None, list_id=None, manually_added=None, observations_count=0, occurrence_status_level=None, primary_listing=None, source_id=None, taxon_id=None, taxon_range_id=None, updated_at=None, list=None, updater=None, user=None)#
Bases:
pyinaturalist.models.taxon_meta.IdWrapperMixin
,pyinaturalist.models.taxon_meta.EstablishmentMeans
A taxon with additional stats associated with a list (aka “original life list”), based on the schema of:
Taxon.listed_taxa
from GET /taxa/{id}TaxonSummary.listed_taxon
from GET /observations/{id}/taxon_summary
Attributes
Name
Type
Description
id
Unique record ID
establishment_means
Establishment means label
Options:
introduced
,native
,endemic
establishment_means_description
Establishment means description
Options:
introduced
,native
,endemic
comments_count
Number of comments for this listed taxon
created_at
Date and time the record was created
description
Listed taxon description
first_observation_id
Oldest recent observation ID in the list
last_observation_id
Most recent observation ID in the list
list_id
manually_added
Indicates if the taxon was manually added to the list
observations_count
Number of observations of this taxon in the list
occurrence_status_level
primary_listing
Indicates if this is the primary listing for this taxon
source_id
taxon_id
taxon_range_id
updated_at
Date and time the record was last updated
list
Checklist
Associated checklist
updater
User that last updated the record
user
User that created the record
_row (
property
)_str_attrs (
property
)Methods
- __init__(id=None, establishment_means=None, establishment_means_description=None, place=None, comments_count=0, created_at=None, description=None, first_observation_id=None, last_observation_id=None, list_id=None, manually_added=None, observations_count=0, occurrence_status_level=None, primary_listing=None, source_id=None, taxon_id=None, taxon_range_id=None, updated_at=None, list=None, updater=None, user=None)#
Method generated by attrs for class ListedTaxon.
- classmethod copy(obj)#
Copy a model object. This is defined as a classmethod to easily initialize a subclass from a parent class instance. For copying an instance to the same type,
copy.deepcopy()
can be used.- Return type
- classmethod from_json(value, **kwargs)#
Initialize a single model object from an API response or response result.
Omits any invalid fields and
None
values, so default factories are used instead (e.g. for empty dicts and lists).
- classmethod from_json_file(value)#
Initialize a collection of model objects from a JSON string, file path, or file-like object
- classmethod from_json_list(value, **kwargs)#
Initialize a collection of model objects from an API response or response results