Version 9-01 1.0 of the Inventory re-introduced URL-based searches. Searches can be initiated by entering a URL to the result page (i.e. /search/result) and adding the appropriate querystrings to define your search criteria.

Search Result Querystrings

Result querystrings provide criteria for plant searches via URL. For example, to obtain a list of California Rare Plant Rank 1B or 2B plants, add ?crpr=1B:2B to the /search/result url so that the resulting URL would read: https://rareplants.cnps.org/search/result?crpr=1B:2B

Note: that all querystrings must start with a question mark (?) immediately after the page name. Both page URL forms /Search/result?crpr=1B:2B and /Search/result/?crpr=1B:2B will function.

Classification

Variable:Name:Description:Options:Example:
famFamilyReturn plants with a specified familyAny plant family namefam=Asteraceae
genus (also gen v8)GenusReturn plants with a specified genusAny plant genus namegenus=ceanothus
taxonTaxon NameScientific names beginning with a specified letterAny single alphabetic charactertaxon=a
commonCommon NameCommon names beginning with a specified letterAny single alphabetic charactercommon=m
specSpecific EpithetReturn plants with a specified Specific EpithetAny specific epithet namespec=breweri
elmElement CodeReturn a plant with a specific NatureServe Element CodeAny element codeelm=PDLIN01030

Conservation Status

Variable:Name:Description:Options:Example:
crpr (also cnps v8)California Rare Plant RankReturns plants matching one or more designated CRPR1A, 1B, 2A, 2B, 3, 4 (optional .1, .2, .3)crpr=1B:2B:3:4 or crpr=2B.2:3.1
fesaFederal List StatusReturns plants matching federal listing statusesFE, FT, FC, Nonefesa=FE:FT
cesaState List StatusReturns plants matching state listing statusesCE, CT, CR, Nonecesa=CE:CT
fsaoFederal And/Or State StatusIndicates whether both fesa and cesa must be true, or either can be trueand, orfesa=FE:FT&cesa=CE:CT&fsao=and
grankGlobal RankReturns plants matching Global RankG1, G2, G3, G4, G5, GH, GX, GU, GNRgrank=G1:G2
gssrankGlobal Subspecies RankReturns plants matching global subspecies/variety ranksT1, T2, T3, T4, T5, TH, TX, TU, TNRgssrank=T1:T2
srankState RankReturns plants matching State RankS1, S2, S3, S4, S5, SH, SX, SU, SNRsrank=S1:S2
iucnIUCN StatusReturns plants matching IUCN StatusesSee Inventory Glossaryiucn=IUCN_CR:IUCN_EN
sbankSeed BankReturns plants matching Seed BanksSee Inventory Glossarysbank=SB_BerrySB:SB_CRES
blmsBLM SensitiveReturns plants with CNDDB BLM Sensitive Other StatusT (true), f (false)blms=T
usfssUSFS SensitiveReturns plants with CNDDB USFS Sensitive Other StatusT (true), f (false)usfss=T
add_afterAdded After YearReturns plants added after Jan 1 of a specified yearFour-digit yearadd_after=2010
add_beforeAdded Before YearReturns plants added before Jan 1 of a specified yearFour-digit yearadd_before=2020

Location

Variable:Name:Description:Options:Example:
endEndemic to CaliforniaReturns plants designated as endemic to CaliforniaT (true), f (false)end=T
islEndemic to IslandsReturns plants designated as endemic to islandsT (true), f (false)isl=T
cclCounty or IslandReturns plants within selected CA counties or islandsThree-letter county/island code (list)ccl=SBA:SBR:SCZ
qslQuad Selection MethodIndicates a 9-quad search (UI text only)9qsl=9
quadQuad Code (Number)Returns plants within designated USGS 7.5' quadrangles7-digit CNDDB quad codequad=3411738:3411737:...:3411746
elevElevation RangeBetween/Overlaps using low, high, units (f/m), type (b/o)0-15000; f/m; b/oelev=2000:4000:f:b
hab (also comm v8)General HabitatsReturns plants within designated habitatsSee Inventory Glossaryhab=Chprl:JTWld:PJWld
microhabMicrohabitatReturns plants within designated microhabitatsSee Inventory Glossarymicrohab=Bajadas:Granitic:Gravelly:Scree

Ecology and Life History

Variable:Name:Description:Options:Example:
lifeLifeformReturns plants matching one or more lifeformstree, herb, shrub, vine, leaf, stem, moss, liverwort, lichenlife=tree:herb:shrub
durDurationReturns plants matching one or more durationsann (annual), per (perennial), ephem (ephemeral)dur=ann:per
bloomBlooming MonthReturns plants that bloom in designated monthsAny three-letter month abbreviationbloom=mar:apr:may

Occurrence Data (Threats)

Variable:Name:Description:Options:Example:
threatsCNDDB Occurrence ThreatsReturns plants that match selected CNDDB threatsSee Inventory Glossarythreats=Channel:WtrQlty:Disease

Global Search

Variable:Name:Description:Options:Example:
global (also fulldata v8)Global SearchReturns plants associated with a designated wordAny search wordglobal=serpentinite

Plant Details Querystrings

Version 9-01 1.0 also added support for direct links to plant detail pages via URLs specifying a scientific name. For example:

https://rareplants.cnps.org/Plants/Details?taxon=Ceanothus+gloriosus+var.+exaltatus

Variable:Name:Description:Options:Example:
taxonSpecific Plant TaxonReturns the Details page for a specified plantAny scientific name (spaces replaced with '+')taxon=Ceanothus+gloriosus+var.+exaltatus

Specifying Multiple Criteria

Querystring criteria can be combined by adding an ampersand (&) between individual querystring clauses. For example:

https://rareplants.cnps.org/Search/result?cnps=1B:2B&grank=G1:G2&bloom=mar:apr:may https://rareplants.cnps.org/search?mode=results&form=advanced&crpr=1B&crpr=2B&g=G1&g=G2&bloom=3&bloom=4&bloom=5

Source: RPI Querystrings