Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Tip
iconfalse

/names

 

Returns a paged list of summary name linksnames details.

Parameters

 All parameters are optional.

...

page 
pagesize 
frommodifieddate 

Example Response

The pagination offset for the list of results starting at 1.
pagesizeThe number of results to display during pagination (default = 10).
frommodifieddateThe earliest modified date for any of the results. The format of the date is yyyy-dd-mm.
parentnameid The unique identifier of the direct parent name.
ancestornameid

The unique identifier of any ancestor name.

biostatus  
status  
Info

Use either the parentNameId or ancestorNameId parameter to retrieve the children or all descendants of a name.

Response

The response will include the full details of the requested names.

NamesAn array of the name details
TotalThe total number of names that match the request parameters.
PageThe pagination offset for the list of results.
PageSizeThe maximum number of records that will be returned for the request.

 

Example response (abbreviated)

<?xml version="1.0" encoding="utf-8"?> <Response xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <Total>122022</Total> <Page>1</Page> <PageSize>10</PageSize> <Names>
Code Block
languagehtml/xml
js
{
    "Names": [
        {
      <NameLink>       <NameId>397b0771-3577-472e-a6e8-00009a4d0b4e</NameId>"NameId": "030e9726-81c5-4aaa-b6d6-dada939f91ab",
      <FullName>Yellowing Curtain Crust</FullName>    "Class": "Scientific Name",
<PartialName/>       <Rank>none</Rank>       <ModifiedDate>2011-11-25T15:20:41.607</ModifiedDate>
    </NameLink>
    <NameLink>
      <NameId>ec4fd43a-3d2d-4a02-a549-00009d57e25b</NameId>
      <FullName>Cryptodacne</FullName>
      <PartialName>Cryptodacne</PartialName>
      <Rank>genus</Rank>
      <ModifiedDate>2011-11-22T11:50:20.14</ModifiedDate>
    </NameLink>"FullName": "Peziza herbarum Pers., 1794",
    <NameLink>       <NameId>bc434dd4-d42c-4e86-b0e1-00013acf2196</NameId>       <FullName>Crepidotus variabilis (Pers.) P. Kumm. 1871</FullName>
      <PartialName>Crepidotus variabilis</PartialName>  },
    <Rank>species</Rank>       <ModifiedDate>2011-11-22T11:50:20.14</ModifiedDate>
    </NameLink>
    <NameLink>
      <NameId>f727fed3-02f4-44e5-9019-0002159b7e46</NameId>
      <FullName>Bombyx</FullName>
      <PartialName>Bombyx</PartialName>
      <Rank>genus</Rank>
      <ModifiedDate>2011-11-22T11:50:20.14</ModifiedDate>
    </NameLink>
    <NameLink>
      <NameId>7574a0be-57e7-42e8-a78a-00026f6f67d9</NameId>
      <FullName>Weigela florida (Bunge) A.DC.</FullName>
    ],
 <PartialName>Weigela florida</PartialName>   "Total": 85,
  <Rank>species</Rank>
      <ModifiedDate>2011-11-22T11:50:20.14</ModifiedDate>
  "Page": 1,
   </NameLink>
    <NameLink>
      <NameId>24cfddf1-8135-4ac0-b906-00034ee7fe61</NameId>
      <FullName>Uncinia uncinata var. pedicellata (Kük.) Petrie 1915</FullName>
      <PartialName>Uncinia uncinata var. pedicellata</PartialName>
      <Rank>variety</Rank>
      <ModifiedDate>2011-11-22T11:50:20.14</ModifiedDate>
    </NameLink>
    <NameLink>
      <NameId>0e506d66-d6a3-422f-aebb-000386da01d0</NameId>
      <FullName>Water speedwell</FullName>
      <PartialName/>
      <Rank>none</Rank>
      <ModifiedDate>2011-11-22T15:20:41.607</ModifiedDate>
    </NameLink>
    <NameLink>
      <NameId>82afa17c-b614-4821-a748-000413075502</NameId>
      <FullName>Kermes oak</FullName>
      <PartialName/>
      <Rank>none</Rank>
      <ModifiedDate>2011-11-22T15:20:41.607</ModifiedDate>
    </NameLink>
    <NameLink>
      <NameId>a628d759-accd-42bd-bf29-000688b6df6d</NameId>
      <FullName>Maoritipula hudsoni Alexander 1924</FullName>
      <PartialName>Maoritipula hudsoni</PartialName>
      <Rank>species</Rank>
      <ModifiedDate>2011-11-22T11:50:20.14</ModifiedDate>
    </NameLink>
    <NameLink>
      <NameId>0ea4f4ac-5199-4f65-ac94-0007ac0691e7</NameId>
      <FullName>Ypsilothuria</FullName>
      <PartialName>Ypsilothuria</PartialName>
      <Rank>genus</Rank>
      <ModifiedDate>2011-11-22T11:50:20.14</ModifiedDate>
    </NameLink>
  </Names>
</Response>

...

 "PageSize": 10
}

Examples

Returning a list of records to maintain a local cache.

Panel
http://data.nzor.org.nz/names?frommodifieddate=2013-1-16

This will return a list of names that have been modified since January 16 2013.