--- openapi: 3.0.1 info: title: Trefle API v1 version: 1.6.0 paths: "/api/v1/kingdoms": get: summary: Searches kingdoms tags: - Kingdoms description: List kingdoms operationId: listKingdoms security: - token: [] parameters: - name: page in: query required: false description: The page to fetch schema: type: number responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: "$ref": "#/components/schemas/kingdom" links: type: object properties: self: type: string description: A link to the current page of the collection first: type: string description: A link to the first page of the collection next: type: string description: A link to the next page of the collection prev: type: string description: A link to the previous page of the collection last: type: string description: A link to the last page of the collection required: - self meta: type: object properties: total: type: integer examples: returns-a-200-response: value: data: - id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" links: self: "/api/v1/kingdoms" first: "/api/v1/kingdoms?page=1" last: "/api/v1/kingdoms?page=1" meta: total: 1 '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/kingdoms/{id}": get: summary: Retrieve a kingdom tags: - Kingdoms description: Get a kingdom operationId: getKingdom parameters: - name: id required: true in: path description: The id or the slug of the requested kingdom schema: type: string security: - token: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: "$ref": "#/components/schemas/kingdom" meta: type: object properties: last_modified: type: string examples: returns-a-200-response: value: data: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" meta: last_modified: '2020-08-11T16:23:03.622Z' '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/subkingdoms": get: summary: Searches subkingdoms tags: - Subkingdoms description: List subkingdoms operationId: listSubkingdoms security: - token: [] parameters: - name: page in: query required: false description: The page to fetch schema: type: number responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: "$ref": "#/components/schemas/subkingdom" links: type: object properties: self: type: string description: A link to the current page of the collection first: type: string description: A link to the first page of the collection next: type: string description: A link to the next page of the collection prev: type: string description: A link to the previous page of the collection last: type: string description: A link to the last page of the collection required: - self meta: type: object properties: total: type: integer examples: returns-a-200-response: value: data: - id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" links: self: "/api/v1/subkingdoms" first: "/api/v1/subkingdoms?page=1" last: "/api/v1/subkingdoms?page=1" meta: total: 1 '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/subkingdoms/{id}": get: summary: Retrieve a subkingdom tags: - Subkingdoms description: Get a subkingdom operationId: getSubkingdom parameters: - name: id required: true in: path description: The id or the slug of the requested sub-kingdom schema: type: string security: - token: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: "$ref": "#/components/schemas/subkingdom" meta: type: object properties: last_modified: type: string examples: returns-a-200-response: value: data: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" meta: last_modified: '2020-08-11T16:23:03.637Z' '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/divisions": get: summary: Searches divisions tags: - Divisions description: List divisions operationId: listDivisions security: - token: [] parameters: - name: page in: query required: false description: The page to fetch schema: type: number responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: "$ref": "#/components/schemas/division" links: type: object properties: self: type: string description: A link to the current page of the collection first: type: string description: A link to the first page of the collection next: type: string description: A link to the next page of the collection prev: type: string description: A link to the previous page of the collection last: type: string description: A link to the last page of the collection required: - self meta: type: object properties: total: type: integer examples: returns-a-200-response: value: data: - id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 2 name: Coniferophyta slug: coniferophyta links: self: "/api/v1/divisions/coniferophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 3 name: Pteridophyta slug: pteridophyta links: self: "/api/v1/divisions/pteridophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 4 name: Cycadophyta slug: cycadophyta links: self: "/api/v1/divisions/cycadophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 5 name: Gnetophyta slug: gnetophyta links: self: "/api/v1/divisions/gnetophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 6 name: Equisetophyta slug: equisetophyta links: self: "/api/v1/divisions/equisetophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 7 name: Ginkgophyta slug: ginkgophyta links: self: "/api/v1/divisions/ginkgophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 8 name: Lycopodiophyta slug: lycopodiophyta links: self: "/api/v1/divisions/lycopodiophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 9 name: Psilophyta slug: psilophyta links: self: "/api/v1/divisions/psilophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" links: self: "/api/v1/divisions" first: "/api/v1/divisions?page=1" last: "/api/v1/divisions?page=1" meta: total: 9 '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/divisions/{id}": get: summary: Retrieve a division tags: - Divisions description: Get a division operationId: getDivision parameters: - name: id required: true in: path description: The id or the slug of the requested division schema: type: string security: - token: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: "$ref": "#/components/schemas/division" meta: type: object properties: last_modified: type: string examples: returns-a-200-response: value: data: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" meta: last_modified: '2020-08-11T16:23:03.651Z' '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/division_classes": get: summary: Searches division classes tags: - DivisionClasses description: List division classes operationId: listDivisionClasses security: - token: [] parameters: - name: page in: query required: false description: The page to fetch schema: type: number responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: "$ref": "#/components/schemas/division_class" links: type: object properties: self: type: string description: A link to the current page of the collection first: type: string description: A link to the first page of the collection next: type: string description: A link to the next page of the collection prev: type: string description: A link to the previous page of the collection last: type: string description: A link to the last page of the collection required: - self meta: type: object properties: total: type: integer examples: returns-a-200-response: value: data: - id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 2 name: Pinopsida slug: pinopsida links: self: "/api/v1/division_classes/pinopsida" division: "/api/v1/divisions/coniferophyta" division: id: 2 name: Coniferophyta slug: coniferophyta links: self: "/api/v1/divisions/coniferophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 4 name: Liliopsida slug: liliopsida links: self: "/api/v1/division_classes/liliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 8 name: Filicopsida slug: filicopsida links: self: "/api/v1/division_classes/filicopsida" division: "/api/v1/divisions/pteridophyta" division: id: 3 name: Pteridophyta slug: pteridophyta links: self: "/api/v1/divisions/pteridophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 14 name: Cycadopsida slug: cycadopsida links: self: "/api/v1/division_classes/cycadopsida" division: "/api/v1/divisions/cycadophyta" division: id: 4 name: Cycadophyta slug: cycadophyta links: self: "/api/v1/divisions/cycadophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 16 name: Gnetopsida slug: gnetopsida links: self: "/api/v1/division_classes/gnetopsida" division: "/api/v1/divisions/gnetophyta" division: id: 5 name: Gnetophyta slug: gnetophyta links: self: "/api/v1/divisions/gnetophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 17 name: Equisetopsida slug: equisetopsida links: self: "/api/v1/division_classes/equisetopsida" division: "/api/v1/divisions/equisetophyta" division: id: 6 name: Equisetophyta slug: equisetophyta links: self: "/api/v1/divisions/equisetophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 18 name: Ginkgoopsida slug: ginkgoopsida links: self: "/api/v1/division_classes/ginkgoopsida" division: "/api/v1/divisions/ginkgophyta" division: id: 7 name: Ginkgophyta slug: ginkgophyta links: self: "/api/v1/divisions/ginkgophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 20 name: Lycopodiopsida slug: lycopodiopsida links: self: "/api/v1/division_classes/lycopodiopsida" division: "/api/v1/divisions/lycopodiophyta" division: id: 8 name: Lycopodiophyta slug: lycopodiophyta links: self: "/api/v1/divisions/lycopodiophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 21 name: Psilopsida slug: psilopsida links: self: "/api/v1/division_classes/psilopsida" division: "/api/v1/divisions/psilophyta" division: id: 9 name: Psilophyta slug: psilophyta links: self: "/api/v1/divisions/psilophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" links: self: "/api/v1/division_classes" first: "/api/v1/division_classes?page=1" last: "/api/v1/division_classes?page=1" meta: total: 10 '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/division_classes/{id}": get: summary: Retrieve a division class tags: - DivisionClasses description: Get a division class operationId: getDivisionClass parameters: - name: id required: true in: path description: The id or the slug of the requested division class schema: type: string security: - token: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: "$ref": "#/components/schemas/division_class" meta: type: object properties: last_modified: type: string examples: returns-a-200-response: value: data: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" meta: last_modified: '2020-08-11T16:23:03.685Z' '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/division_orders": get: summary: Searches division orders tags: - DivisionOrders description: List division orders operationId: listDivisionOrders security: - token: [] parameters: - name: page in: query required: false description: The page to fetch schema: type: number responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: "$ref": "#/components/schemas/division_order" links: type: object properties: self: type: string description: A link to the current page of the collection first: type: string description: A link to the first page of the collection next: type: string description: A link to the next page of the collection prev: type: string description: A link to the previous page of the collection last: type: string description: A link to the last page of the collection required: - self meta: type: object properties: total: type: integer examples: returns-a-200-response: value: data: - id: 1 name: Dipsacales slug: dipsacales links: self: "/api/v1/division_orders/dipsacales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 2 name: Malvales slug: malvales links: self: "/api/v1/division_orders/malvales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 3 name: Pinales slug: pinales links: self: "/api/v1/division_orders/pinales" division_class: "/api/v1/division_classes/pinopsida" division_class: id: 2 name: Pinopsida slug: pinopsida links: self: "/api/v1/division_classes/pinopsida" division: "/api/v1/divisions/coniferophyta" division: id: 2 name: Coniferophyta slug: coniferophyta links: self: "/api/v1/divisions/coniferophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 5 name: Cyperales slug: cyperales links: self: "/api/v1/division_orders/cyperales" division_class: "/api/v1/division_classes/liliopsida" division_class: id: 4 name: Liliopsida slug: liliopsida links: self: "/api/v1/division_classes/liliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 6 name: Caryophyllales slug: caryophyllales links: self: "/api/v1/division_orders/caryophyllales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 8 name: Fabales slug: fabales links: self: "/api/v1/division_orders/fabales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 10 name: Rosales slug: rosales links: self: "/api/v1/division_orders/rosales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 11 name: Euphorbiales slug: euphorbiales links: self: "/api/v1/division_orders/euphorbiales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 12 name: Asterales slug: asterales links: self: "/api/v1/division_orders/asterales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 13 name: Lamiales slug: lamiales links: self: "/api/v1/division_orders/lamiales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 14 name: Scrophulariales slug: scrophulariales links: self: "/api/v1/division_orders/scrophulariales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 17 name: Sapindales slug: sapindales links: self: "/api/v1/division_orders/sapindales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 18 name: Ranunculales slug: ranunculales links: self: "/api/v1/division_orders/ranunculales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 19 name: Calycerales slug: calycerales links: self: "/api/v1/division_orders/calycerales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 20 name: Liliales slug: liliales links: self: "/api/v1/division_orders/liliales" division_class: "/api/v1/division_classes/liliopsida" division_class: id: 4 name: Liliopsida slug: liliopsida links: self: "/api/v1/division_classes/liliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 21 name: Apiales slug: apiales links: self: "/api/v1/division_orders/apiales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 22 name: Myrtales slug: myrtales links: self: "/api/v1/division_orders/myrtales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 23 name: Solanales slug: solanales links: self: "/api/v1/division_orders/solanales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 24 name: Arecales slug: arecales links: self: "/api/v1/division_orders/arecales" division_class: "/api/v1/division_classes/liliopsida" division_class: id: 4 name: Liliopsida slug: liliopsida links: self: "/api/v1/division_classes/liliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 25 name: Arales slug: arales links: self: "/api/v1/division_orders/arales" division_class: "/api/v1/division_classes/liliopsida" division_class: id: 4 name: Liliopsida slug: liliopsida links: self: "/api/v1/division_classes/liliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" links: self: "/api/v1/division_orders" first: "/api/v1/division_orders?page=1" next: "/api/v1/division_orders?page=2" last: "/api/v1/division_orders?page=5" meta: total: 93 '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/division_orders/{id}": get: summary: Retrieve a division order tags: - DivisionOrders description: Get a division order operationId: getDivisionOrder parameters: - name: id required: true in: path description: The id or the slug of the requested division order schema: type: string security: - token: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: "$ref": "#/components/schemas/division_order" meta: type: object properties: last_modified: type: string examples: returns-a-200-response: value: data: id: 1 name: Dipsacales slug: dipsacales links: self: "/api/v1/division_orders/dipsacales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" meta: last_modified: '2020-08-11T16:23:03.716Z' '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/families": get: summary: Searches families tags: - Families description: List families operationId: listFamilies security: - token: [] parameters: - name: page in: query required: false description: The page to fetch schema: type: number - name: filter in: query required: false type: object description: Filter on values schema: "$ref": "#/components/schemas/filters_families" - name: order in: query required: false type: object description: Sort on values schema: "$ref": "#/components/schemas/sorts_families" responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: "$ref": "#/components/schemas/family" links: type: object properties: self: type: string description: A link to the current page of the collection first: type: string description: A link to the first page of the collection next: type: string description: A link to the next page of the collection prev: type: string description: A link to the previous page of the collection last: type: string description: A link to the last page of the collection required: - self meta: type: object properties: total: type: integer examples: returns-a-200-response: value: data: - id: 168 name: Cupressaceae common_name: Cypress family slug: cupressaceae links: self: "/api/v1/families/cupressaceae" division_order: "/api/v1/division_orders/pinales" genus: "/api/v1/families/cupressaceae/genus" division_order: id: 3 name: Pinales slug: pinales links: self: "/api/v1/division_orders/pinales" division_class: "/api/v1/division_classes/pinopsida" division_class: id: 2 name: Pinopsida slug: pinopsida links: self: "/api/v1/division_classes/pinopsida" division: "/api/v1/divisions/coniferophyta" division: id: 2 name: Coniferophyta slug: coniferophyta links: self: "/api/v1/divisions/coniferophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 9 name: Fabaceae common_name: Pea family slug: fabaceae links: self: "/api/v1/families/fabaceae" division_order: "/api/v1/division_orders/fabales" genus: "/api/v1/families/fabaceae/genus" division_order: id: 8 name: Fabales slug: fabales links: self: "/api/v1/division_orders/fabales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 172 name: Myrtaceae common_name: Myrtle family slug: myrtaceae links: self: "/api/v1/families/myrtaceae" division_order: "/api/v1/division_orders/myrtales" genus: "/api/v1/families/myrtaceae/genus" division_order: id: 22 name: Myrtales slug: myrtales links: self: "/api/v1/division_orders/myrtales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 3 name: Pinaceae common_name: Pine family slug: pinaceae links: self: "/api/v1/families/pinaceae" division_order: "/api/v1/division_orders/pinales" genus: "/api/v1/families/pinaceae/genus" division_order: id: 3 name: Pinales slug: pinales links: self: "/api/v1/division_orders/pinales" division_class: "/api/v1/division_classes/pinopsida" division_class: id: 2 name: Pinopsida slug: pinopsida links: self: "/api/v1/division_classes/pinopsida" division: "/api/v1/divisions/coniferophyta" division: id: 2 name: Coniferophyta slug: coniferophyta links: self: "/api/v1/divisions/coniferophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 11 name: Rosaceae common_name: Rose family slug: rosaceae links: self: "/api/v1/families/rosaceae" division_order: "/api/v1/division_orders/rosales" genus: "/api/v1/families/rosaceae/genus" division_order: id: 10 name: Rosales slug: rosales links: self: "/api/v1/division_orders/rosales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" - id: 484 name: Salicaceae common_name: Willow family slug: salicaceae links: self: "/api/v1/families/salicaceae" division_order: "/api/v1/division_orders/salicales" genus: "/api/v1/families/salicaceae/genus" division_order: id: 145 name: Salicales slug: salicales links: self: "/api/v1/division_orders/salicales" division_class: "/api/v1/division_classes/magnoliopsida" division_class: id: 1 name: Magnoliopsida slug: magnoliopsida links: self: "/api/v1/division_classes/magnoliopsida" division: "/api/v1/divisions/magnoliophyta" division: id: 1 name: Magnoliophyta slug: magnoliophyta links: self: "/api/v1/divisions/magnoliophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" links: self: "/api/v1/families" first: "/api/v1/families?page=1" last: "/api/v1/families?page=1" meta: total: 6 '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/families/{id}": get: summary: Retrieve a family tags: - Families description: Get a family operationId: getFamily parameters: - name: id required: true in: path description: The id or the slug of the requested family schema: type: string security: - token: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: "$ref": "#/components/schemas/family" meta: type: object properties: last_modified: type: string examples: returns-a-200-response: value: data: id: 3 name: Pinaceae common_name: Pine family slug: pinaceae links: self: "/api/v1/families/pinaceae" division_order: "/api/v1/division_orders/pinales" genus: "/api/v1/families/pinaceae/genus" division_order: id: 3 name: Pinales slug: pinales links: self: "/api/v1/division_orders/pinales" division_class: "/api/v1/division_classes/pinopsida" division_class: id: 2 name: Pinopsida slug: pinopsida links: self: "/api/v1/division_classes/pinopsida" division: "/api/v1/divisions/coniferophyta" division: id: 2 name: Coniferophyta slug: coniferophyta links: self: "/api/v1/divisions/coniferophyta" subkingdom: "/api/v1/subkingdoms/tracheobionta" subkingdom: id: 1 name: Tracheobionta slug: tracheobionta links: self: "/api/v1/subkingdoms/tracheobionta" kingdom: "/api/v1/kingdoms/plantae" kingdom: id: 1 name: Plantae slug: plantae links: self: "/api/v1/kingdoms/plantae" meta: last_modified: '2020-08-11T16:23:03.954Z' '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/genus": get: summary: Searches genus tags: - Genus description: List genus operationId: listGenus parameters: - name: filter in: query required: false type: object description: Filter on values schema: "$ref": "#/components/schemas/filters_genus" - name: order in: query required: false type: object description: Sort on values schema: "$ref": "#/components/schemas/sorts_genus" - name: page in: query required: false description: The page to fetch schema: type: number security: - token: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: "$ref": "#/components/schemas/genus" links: type: object properties: self: type: string description: A link to the current page of the collection first: type: string description: A link to the first page of the collection next: type: string description: A link to the next page of the collection prev: type: string description: A link to the previous page of the collection last: type: string description: A link to the last page of the collection required: - self meta: type: object properties: total: type: integer examples: returns-a-200-response: value: data: - id: 4 name: Abies slug: abies links: self: "/api/v1/genus/abies" plants: "/api/v1/genus/abies/plants" species: "/api/v1/genus/abies/species" family: "/api/v1/families/pinaceae" family: id: 3 name: Pinaceae common_name: Pine family slug: pinaceae links: self: "/api/v1/families/pinaceae" division_order: "/api/v1/division_orders/pinales" genus: "/api/v1/families/pinaceae/genus" - id: 21 name: Acacia slug: acacia links: self: "/api/v1/genus/acacia" plants: "/api/v1/genus/acacia/plants" species: "/api/v1/genus/acacia/species" family: "/api/v1/families/fabaceae" family: id: 9 name: Fabaceae common_name: Pea family slug: fabaceae links: self: "/api/v1/families/fabaceae" division_order: "/api/v1/division_orders/fabales" genus: "/api/v1/families/fabaceae/genus" - id: 1322 name: Calocedrus slug: calocedrus links: self: "/api/v1/genus/calocedrus" plants: "/api/v1/genus/calocedrus/plants" species: "/api/v1/genus/calocedrus/species" family: "/api/v1/families/cupressaceae" family: id: 168 name: Cupressaceae common_name: Cypress family slug: cupressaceae links: self: "/api/v1/families/cupressaceae" division_order: "/api/v1/division_orders/pinales" genus: "/api/v1/families/cupressaceae/genus" - id: 2059 name: Eucalyptus slug: eucalyptus links: self: "/api/v1/genus/eucalyptus" plants: "/api/v1/genus/eucalyptus/plants" species: "/api/v1/genus/eucalyptus/species" family: "/api/v1/families/myrtaceae" family: id: 172 name: Myrtaceae common_name: Myrtle family slug: myrtaceae links: self: "/api/v1/families/myrtaceae" division_order: "/api/v1/division_orders/myrtales" genus: "/api/v1/families/myrtaceae/genus" - id: 1380 name: Eugenia slug: eugenia links: self: "/api/v1/genus/eugenia" plants: "/api/v1/genus/eugenia/plants" species: "/api/v1/genus/eugenia/species" family: "/api/v1/families/myrtaceae" family: id: 172 name: Myrtaceae common_name: Myrtle family slug: myrtaceae links: self: "/api/v1/families/myrtaceae" division_order: "/api/v1/division_orders/myrtales" genus: "/api/v1/families/myrtaceae/genus" - id: 5568 name: Populus slug: populus links: self: "/api/v1/genus/populus" plants: "/api/v1/genus/populus/plants" species: "/api/v1/genus/populus/species" family: "/api/v1/families/salicaceae" family: id: 484 name: Salicaceae common_name: Willow family slug: salicaceae links: self: "/api/v1/families/salicaceae" division_order: "/api/v1/division_orders/salicales" genus: "/api/v1/families/salicaceae/genus" - id: 5912 name: Rosa slug: rosa links: self: "/api/v1/genus/rosa" plants: "/api/v1/genus/rosa/plants" species: "/api/v1/genus/rosa/species" family: "/api/v1/families/rosaceae" family: id: 11 name: Rosaceae common_name: Rose family slug: rosaceae links: self: "/api/v1/families/rosaceae" division_order: "/api/v1/division_orders/rosales" genus: "/api/v1/families/rosaceae/genus" links: self: "/api/v1/genus" first: "/api/v1/genus?page=1" last: "/api/v1/genus?page=1" meta: total: 7 '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/genus/{id}": get: summary: Retrieve a genus tags: - Genus description: Get a genus operationId: getGenus parameters: - name: id required: true in: path description: The id or the slug of the requested genus schema: type: string security: - token: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: "$ref": "#/components/schemas/genus" meta: type: object properties: last_modified: type: string examples: returns-a-200-response: value: data: id: 4 name: Abies slug: abies links: self: "/api/v1/genus/abies" plants: "/api/v1/genus/abies/plants" species: "/api/v1/genus/abies/species" family: "/api/v1/families/pinaceae" family: id: 3 name: Pinaceae common_name: Pine family slug: pinaceae links: self: "/api/v1/families/pinaceae" division_order: "/api/v1/division_orders/pinales" genus: "/api/v1/families/pinaceae/genus" meta: last_modified: '2020-08-11T16:23:03.968Z' '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/plants": get: summary: List plants tags: - Plants description: List plants operationId: listPlants security: - token: [] parameters: - name: filter in: query required: false type: object description: Filter on values schema: "$ref": "#/components/schemas/filters_species" - name: filter_not in: query required: false type: object description: Exclude results matching null values schema: "$ref": "#/components/schemas/filters_not_species" - name: order in: query required: false type: object description: Sort on values schema: "$ref": "#/components/schemas/sorts_species" - name: range in: query required: false type: object description: Range on values schema: "$ref": "#/components/schemas/ranges_species" - name: page in: query required: false description: The page to fetch schema: type: number responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: "$ref": "#/components/schemas/species_light" links: type: object properties: self: type: string description: A link to the current page of the collection first: type: string description: A link to the first page of the collection next: type: string description: A link to the next page of the collection prev: type: string description: A link to the previous page of the collection last: type: string description: A link to the last page of the collection required: - self meta: type: object properties: total: type: integer examples: returns-a-200-response: value: data: - id: 1164724 common_name: slug: abies-alba scientific_name: Abies alba year: bibliography: author: Mill. status: accepted rank: species family_common_name: genus_id: 4 image_url: synonyms: [] genus: Abies family: Pinaceae links: self: "/api/v1/species/abies-alba" plant: "/api/v1/plants/abies-alba" genus: "/api/v1/genus/abies" - id: 170054 common_name: white poplar slug: populus-alba scientific_name: Populus alba year: 1753 bibliography: 'Sp. Pl.: 1034 (1753)' author: L. status: accepted rank: species family_common_name: Willow family genus_id: 5568 image_url: https://bs.floristic.org/image/o/fae7ede0f0fb6e7fd6c57c7f48c93af9262cb13a synonyms: - Populus hybrida - Populus hickeliana - Populus bachofenii - Populus aegyptiaca - Populus caspica - Populus nivea - Populus bolleana - Populus major - Leuce alba - Populus berkarensis - Populus alba var. bolleana genus: Populus family: Salicaceae links: self: "/api/v1/species/populus-alba" plant: "/api/v1/plants/populus-alba" genus: "/api/v1/genus/populus" - id: 175834 common_name: rugosa rose slug: rosa-rugosa scientific_name: Rosa rugosa year: 1784 bibliography: 'J.A.Murray, Syst. Veg., ed. 14: 473 (1784)' author: Thunb. status: accepted rank: species family_common_name: Rose family genus_id: 5912 image_url: https://bs.floristic.org/image/o/fe957b1a87df808443782ad72c2c0ddec0729370 synonyms: - Rosa coruscans - Rosa ferox - Rosa regeliana - Rosa kamtchatica - Rosa andreae - Rosa rugosa var. albiflora genus: Rosa family: Rosaceae links: self: "/api/v1/species/rosa-rugosa" plant: "/api/v1/plants/rosa-rugosa" genus: "/api/v1/genus/rosa" - id: 101355 common_name: slug: acacia-dietrichiana scientific_name: Acacia dietrichiana year: 1882 bibliography: 'S. Sci. Rec. 2: 149 (1882)' author: F.Muell. status: accepted rank: species family_common_name: Pea family genus_id: 21 image_url: http://d2seqvvyy3b8p2.cloudfront.net/921d2e77ad5f50113a0d16236ca257b6.jpg synonyms: - Acacia juncifolia var. planifolia - Racosperma dietrichianum genus: Acacia family: Fabaceae links: self: "/api/v1/species/acacia-dietrichiana" plant: "/api/v1/plants/acacia-dietrichiana" genus: "/api/v1/genus/acacia" - id: 546498 common_name: Chinese Incense-cedar slug: calocedrus-macrolepis scientific_name: Calocedrus macrolepis year: 1878 bibliography: 'J. Bot. 11: 196 (1878)' author: Kurz status: accepted rank: species family_common_name: genus_id: 1322 image_url: https://bs.floristic.org/image/o/05b702e76b77091cf51662fe2874f78740b01290 synonyms: - Heyderia macrolepis - Thuja macrolepis - Libocedrus macrolepis genus: Calocedrus family: Cupressaceae links: self: "/api/v1/species/calocedrus-macrolepis" plant: "/api/v1/plants/calocedrus-macrolepis" genus: "/api/v1/genus/calocedrus" - id: 819657 common_name: slug: eugenia-websteri scientific_name: Eugenia websteri year: 1982 bibliography: 'J. Arnold Arbor. 63: 276 (1982)' author: Proctor status: accepted rank: species family_common_name: genus_id: 1380 image_url: synonyms: [] genus: Eugenia family: Myrtaceae links: self: "/api/v1/species/eugenia-websteri" plant: "/api/v1/plants/eugenia-websteri" genus: "/api/v1/genus/eugenia" - id: 814834 common_name: slug: eucalyptus-nebulosa scientific_name: Eucalyptus nebulosa year: 2008 bibliography: 'Kanunnah 3: 42 (2008)' author: A.M.Gray status: accepted rank: species family_common_name: genus_id: 2059 image_url: synonyms: [] genus: Eucalyptus family: Myrtaceae links: self: "/api/v1/species/eucalyptus-nebulosa" plant: "/api/v1/plants/eucalyptus-nebulosa" genus: "/api/v1/genus/eucalyptus" links: self: "/api/v1/plants" first: "/api/v1/plants?page=1" last: "/api/v1/plants?page=1" meta: total: 7 '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/plants/{id}": get: summary: Retrieve a plant tags: - Plants description: Get a plant operationId: getPlant parameters: - name: id required: true in: path description: The id or the slug of the requested plant schema: type: string security: - token: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: "$ref": "#/components/schemas/plant" meta: type: object properties: last_modified: type: string examples: returns-a-200-response: value: data: id: 416205 common_name: slug: eucalyptus-nebulosa scientific_name: Eucalyptus nebulosa main_species_id: 814834 image_url: year: 2008 bibliography: 'Kanunnah 3: 42 (2008)' author: A.M.Gray family_common_name: genus_id: 2059 observations: Tasmania vegetable: false links: self: "/api/v1/plants/eucalyptus-nebulosa" species: "/api/v1/plants/eucalyptus-nebulosa/species" genus: "/api/v1/genus/eucalyptus" main_species: id: 814834 common_name: slug: eucalyptus-nebulosa scientific_name: Eucalyptus nebulosa year: 2008 bibliography: 'Kanunnah 3: 42 (2008)' author: A.M.Gray status: accepted rank: species family_common_name: genus_id: 2059 observations: Tasmania image_url: genus: Eucalyptus family: Myrtaceae duration: images: flower: [] leaf: [] habit: [] fruit: [] bark: [] other: [] common_names: {} distribution: native: - Tasmania distributions: native: - id: 215 name: Tasmania slug: tasmania tdwg_code: TAS tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/tasmania" plants: "/api/v1/distributions/tasmania/plants" species: "/api/v1/distributions/tasmania/species" flower: color: conspicuous: foliage: texture: color: leaf_retention: fruit_or_seed: conspicuous: color: shape: seed_persistence: specifications: ligneous_type: growth_form: growth_habit: growth_rate: average_height: cm: maximum_height: cm: nitrogen_fixation: shape_and_orientation: toxicity: growth: description: sowing: days_to_harvest: row_spacing: cm: spread: cm: ph_maximum: ph_minimum: light: atmospheric_humidity: growth_months: bloom_months: fruit_months: minimum_precipitation: mm: maximum_precipitation: mm: minimum_root_depth: cm: minimum_temperature: deg_f: deg_c: maximum_temperature: deg_f: deg_c: soil_nutriments: soil_salinity: soil_texture: soil_humidity: links: self: "/api/v1/species/eucalyptus-nebulosa" plant: "/api/v1/plants/eucalyptus-nebulosa" genus: "/api/v1/genus/eucalyptus" synonyms: [] sources: - last_update: '2020-06-26T03:44:08.000Z' id: urn:lsid:ipni.org:names:77094385-1 name: POWO url: http://powo.science.kew.org/taxon/urn:lsid:ipni.org:names:77094385-1 citation: POWO (2019). Plants of the World Online. Facilitated by the Royal Botanic Gardens, Kew. Published on the Internet; http://www.plantsoftheworldonline.org/ Retrieved 2020-06-26 genus: id: 2059 name: Eucalyptus slug: eucalyptus links: self: "/api/v1/genus/eucalyptus" plants: "/api/v1/genus/eucalyptus/plants" species: "/api/v1/genus/eucalyptus/species" family: "/api/v1/families/myrtaceae" family: id: 172 name: Myrtaceae common_name: Myrtle family slug: myrtaceae links: self: "/api/v1/families/myrtaceae" division_order: "/api/v1/division_orders/myrtales" genus: "/api/v1/families/myrtaceae/genus" species: - id: 814834 common_name: slug: eucalyptus-nebulosa scientific_name: Eucalyptus nebulosa year: 2008 bibliography: 'Kanunnah 3: 42 (2008)' author: A.M.Gray status: accepted rank: species family_common_name: genus_id: 2059 image_url: synonyms: [] genus: Eucalyptus family: Myrtaceae links: self: "/api/v1/species/eucalyptus-nebulosa" plant: "/api/v1/plants/eucalyptus-nebulosa" genus: "/api/v1/genus/eucalyptus" subspecies: [] varieties: [] hybrids: [] forms: [] subvarieties: [] sources: - last_update: '2020-06-26T03:44:08.000Z' id: urn:lsid:ipni.org:names:77094385-1 name: POWO url: http://powo.science.kew.org/taxon/urn:lsid:ipni.org:names:77094385-1 citation: POWO (2019). Plants of the World Online. Facilitated by the Royal Botanic Gardens, Kew. Published on the Internet; http://www.plantsoftheworldonline.org/ Retrieved 2020-06-26 meta: last_modified: '2020-08-11T16:23:04.080Z' '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/plants/search": get: summary: Search for a plant tags: - Plants description: Search for a plant with the given scientific name, common name, synonym name etc. operationId: searchPlants parameters: - name: q required: true in: query description: The string to search schema: type: string - name: page in: query required: false description: The page to fetch schema: type: number - name: filter in: query required: false type: object description: Filter on values schema: "$ref": "#/components/schemas/filters_plants" - name: filter_not in: query required: false type: object description: Exclude results matching null values schema: "$ref": "#/components/schemas/filters_not_species" - name: order in: query required: false type: object description: Sort on values schema: "$ref": "#/components/schemas/sorts_plants" - name: range in: query required: false type: object description: Range on values schema: "$ref": "#/components/schemas/ranges_plants" security: - token: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: "$ref": "#/components/schemas/species_light" links: type: object properties: self: type: string description: A link to the current page of the collection first: type: string description: A link to the first page of the collection next: type: string description: A link to the next page of the collection prev: type: string description: A link to the previous page of the collection last: type: string description: A link to the last page of the collection required: - self meta: type: object properties: total: type: integer examples: returns-a-200-response: value: data: [] links: self: "/api/v1/plants/search?q=cocos" first: "/api/v1/plants/search?page=1&q=cocos" last: "/api/v1/plants/search?page=1&q=cocos" meta: total: 0 "/api/v1/plants/{id}/report": post: summary: Report an error tags: - Plants description: A short API call to report an error regarding a plant entry operationId: reportPlants parameters: - name: id required: true in: path description: The id or the slug of the requested species schema: type: string security: - token: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: "$ref": "#/components/schemas/correction" meta: type: object properties: last_modified: type: string examples: returns-a-200-response: value: data: id: 1 record_type: Species record_id: 170054 user_id: 19 warning_type: report change_status: pending change_type: update accepted_by: notes: The flower color is red created_at: '2020-08-11T16:23:09.550Z' updated_at: '2020-08-11T16:23:09.551Z' correction: changes: meta: last_modified: '2020-08-11T16:23:09.551Z' '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token requestBody: content: application/json: schema: type: object properties: notes: type: string example: The flower color is red description: An optional note about the incorrect data "/api/v1/distributions/{zone_id}/plants": get: summary: List plants in a distribution zone tags: - Plants description: List all the plants in the requested zone. operationId: listPlantsZone security: - token: [] parameters: - name: zone_id required: true in: path description: The zone id or slug schema: type: string - name: filter in: query required: false type: object description: Filter on values schema: "$ref": "#/components/schemas/filters_species" - name: filter_not in: query required: false type: object description: Exclude results matching null values schema: "$ref": "#/components/schemas/filters_not_species" - name: order in: query required: false type: object description: Sort on values schema: "$ref": "#/components/schemas/sorts_species" - name: range in: query required: false type: object description: Range on values schema: "$ref": "#/components/schemas/ranges_species" - name: page in: query required: false description: The page to fetch schema: type: number responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: "$ref": "#/components/schemas/species_light" links: type: object properties: self: type: string description: A link to the current page of the collection first: type: string description: A link to the first page of the collection next: type: string description: A link to the next page of the collection prev: type: string description: A link to the previous page of the collection last: type: string description: A link to the last page of the collection required: - self meta: type: object properties: total: type: integer examples: returns-a-200-response: value: data: - id: 170054 common_name: white poplar slug: populus-alba scientific_name: Populus alba year: 1753 bibliography: 'Sp. Pl.: 1034 (1753)' author: L. status: accepted rank: species family_common_name: Willow family genus_id: 5568 image_url: https://bs.floristic.org/image/o/fae7ede0f0fb6e7fd6c57c7f48c93af9262cb13a synonyms: - Populus hybrida - Populus hickeliana - Populus bachofenii - Populus aegyptiaca - Populus caspica - Populus nivea - Populus bolleana - Populus major - Leuce alba - Populus berkarensis - Populus alba var. bolleana genus: Populus family: Salicaceae links: self: "/api/v1/species/populus-alba" plant: "/api/v1/plants/populus-alba" genus: "/api/v1/genus/populus" - id: 546498 common_name: Chinese Incense-cedar slug: calocedrus-macrolepis scientific_name: Calocedrus macrolepis year: 1878 bibliography: 'J. Bot. 11: 196 (1878)' author: Kurz status: accepted rank: species family_common_name: genus_id: 1322 image_url: https://bs.floristic.org/image/o/05b702e76b77091cf51662fe2874f78740b01290 synonyms: - Heyderia macrolepis - Thuja macrolepis - Libocedrus macrolepis genus: Calocedrus family: Cupressaceae links: self: "/api/v1/species/calocedrus-macrolepis" plant: "/api/v1/plants/calocedrus-macrolepis" genus: "/api/v1/genus/calocedrus" links: self: "/api/v1/plants?zone_id=china-southeast" first: "/api/v1/plants?page=1&zone_id=china-southeast" last: "/api/v1/plants?page=1&zone_id=china-southeast" meta: total: 2 '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/genus/{genus_id}/plants": get: summary: List plants of a genus tags: - Plants description: List plants of the requested genus operationId: listPlantsGenus security: - token: [] parameters: - name: genus_id required: true in: path description: The genus id or slug schema: type: string - name: filter in: query required: false type: object description: Filter on values schema: "$ref": "#/components/schemas/filters_species" - name: filter_not in: query required: false type: object description: Exclude results matching null values schema: "$ref": "#/components/schemas/filters_not_species" - name: order in: query required: false type: object description: Sort on values schema: "$ref": "#/components/schemas/sorts_species" - name: range in: query required: false type: object description: Range on values schema: "$ref": "#/components/schemas/ranges_species" - name: page in: query required: false description: The page to fetch schema: type: number responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: "$ref": "#/components/schemas/species_light" links: type: object properties: self: type: string description: A link to the current page of the collection first: type: string description: A link to the first page of the collection next: type: string description: A link to the next page of the collection prev: type: string description: A link to the previous page of the collection last: type: string description: A link to the last page of the collection required: - self meta: type: object properties: total: type: integer examples: returns-a-200-response: value: data: - id: 814834 common_name: slug: eucalyptus-nebulosa scientific_name: Eucalyptus nebulosa year: 2008 bibliography: 'Kanunnah 3: 42 (2008)' author: A.M.Gray status: accepted rank: species family_common_name: genus_id: 2059 image_url: synonyms: [] genus: Eucalyptus family: Myrtaceae links: self: "/api/v1/species/eucalyptus-nebulosa" plant: "/api/v1/plants/eucalyptus-nebulosa" genus: "/api/v1/genus/eucalyptus" links: self: "/api/v1/plants?genus_id=eucalyptus" first: "/api/v1/plants?genus_id=eucalyptus&page=1" last: "/api/v1/plants?genus_id=eucalyptus&page=1" meta: total: 1 '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/species": get: summary: List species tags: - Species description: List species operationId: listSpecies security: - token: [] parameters: - name: filter in: query required: false type: object description: Filter on values schema: "$ref": "#/components/schemas/filters_species" - name: filter_not in: query required: false type: object description: Exclude results matching null values schema: "$ref": "#/components/schemas/filters_not_species" - name: order in: query required: false type: object description: Sort on values schema: "$ref": "#/components/schemas/sorts_species" - name: range in: query required: false type: object description: Range on values schema: "$ref": "#/components/schemas/ranges_species" - name: page in: query required: false description: The page to fetch schema: type: number responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: "$ref": "#/components/schemas/species_light" links: type: object properties: self: type: string description: A link to the current page of the collection first: type: string description: A link to the first page of the collection next: type: string description: A link to the next page of the collection prev: type: string description: A link to the previous page of the collection last: type: string description: A link to the last page of the collection required: - self meta: type: object properties: total: type: integer examples: returns-a-200-response: value: data: - id: 1164724 common_name: slug: abies-alba scientific_name: Abies alba year: bibliography: author: Mill. status: accepted rank: species family_common_name: genus_id: 4 image_url: synonyms: [] genus: Abies family: Pinaceae links: self: "/api/v1/species/abies-alba" plant: "/api/v1/plants/abies-alba" genus: "/api/v1/genus/abies" - id: 170054 common_name: white poplar slug: populus-alba scientific_name: Populus alba year: 1753 bibliography: 'Sp. Pl.: 1034 (1753)' author: L. status: accepted rank: species family_common_name: Willow family genus_id: 5568 image_url: https://bs.floristic.org/image/o/fae7ede0f0fb6e7fd6c57c7f48c93af9262cb13a synonyms: - Populus hybrida - Populus hickeliana - Populus bachofenii - Populus aegyptiaca - Populus caspica - Populus nivea - Populus bolleana - Populus major - Leuce alba - Populus berkarensis - Populus alba var. bolleana genus: Populus family: Salicaceae links: self: "/api/v1/species/populus-alba" plant: "/api/v1/plants/populus-alba" genus: "/api/v1/genus/populus" - id: 175834 common_name: rugosa rose slug: rosa-rugosa scientific_name: Rosa rugosa year: 1784 bibliography: 'J.A.Murray, Syst. Veg., ed. 14: 473 (1784)' author: Thunb. status: accepted rank: species family_common_name: Rose family genus_id: 5912 image_url: https://bs.floristic.org/image/o/fe957b1a87df808443782ad72c2c0ddec0729370 synonyms: - Rosa coruscans - Rosa ferox - Rosa regeliana - Rosa kamtchatica - Rosa andreae - Rosa rugosa var. albiflora genus: Rosa family: Rosaceae links: self: "/api/v1/species/rosa-rugosa" plant: "/api/v1/plants/rosa-rugosa" genus: "/api/v1/genus/rosa" - id: 101355 common_name: slug: acacia-dietrichiana scientific_name: Acacia dietrichiana year: 1882 bibliography: 'S. Sci. Rec. 2: 149 (1882)' author: F.Muell. status: accepted rank: species family_common_name: Pea family genus_id: 21 image_url: http://d2seqvvyy3b8p2.cloudfront.net/921d2e77ad5f50113a0d16236ca257b6.jpg synonyms: - Acacia juncifolia var. planifolia - Racosperma dietrichianum genus: Acacia family: Fabaceae links: self: "/api/v1/species/acacia-dietrichiana" plant: "/api/v1/plants/acacia-dietrichiana" genus: "/api/v1/genus/acacia" - id: 546498 common_name: Chinese Incense-cedar slug: calocedrus-macrolepis scientific_name: Calocedrus macrolepis year: 1878 bibliography: 'J. Bot. 11: 196 (1878)' author: Kurz status: accepted rank: species family_common_name: genus_id: 1322 image_url: https://bs.floristic.org/image/o/05b702e76b77091cf51662fe2874f78740b01290 synonyms: - Heyderia macrolepis - Thuja macrolepis - Libocedrus macrolepis genus: Calocedrus family: Cupressaceae links: self: "/api/v1/species/calocedrus-macrolepis" plant: "/api/v1/plants/calocedrus-macrolepis" genus: "/api/v1/genus/calocedrus" - id: 1163469 common_name: white poplar slug: populus-alba-subsp-pyramidalis scientific_name: Populus alba subsp. pyramidalis year: 1753 bibliography: 'Sp. Pl.: 1034 (1753)' author: W.Wettstein ex E.Janchen (Bunge) status: unknown rank: ssp family_common_name: Willow family genus_id: 5568 image_url: synonyms: - Populus alba var. pyramidalis genus: Populus family: Salicaceae links: self: "/api/v1/species/populus-alba-subsp-pyramidalis" plant: "/api/v1/plants/populus-alba" genus: "/api/v1/genus/populus" - id: 819657 common_name: slug: eugenia-websteri scientific_name: Eugenia websteri year: 1982 bibliography: 'J. Arnold Arbor. 63: 276 (1982)' author: Proctor status: accepted rank: species family_common_name: genus_id: 1380 image_url: synonyms: [] genus: Eugenia family: Myrtaceae links: self: "/api/v1/species/eugenia-websteri" plant: "/api/v1/plants/eugenia-websteri" genus: "/api/v1/genus/eugenia" - id: 814834 common_name: slug: eucalyptus-nebulosa scientific_name: Eucalyptus nebulosa year: 2008 bibliography: 'Kanunnah 3: 42 (2008)' author: A.M.Gray status: accepted rank: species family_common_name: genus_id: 2059 image_url: synonyms: [] genus: Eucalyptus family: Myrtaceae links: self: "/api/v1/species/eucalyptus-nebulosa" plant: "/api/v1/plants/eucalyptus-nebulosa" genus: "/api/v1/genus/eucalyptus" - id: 175835 common_name: rugosa rose slug: rosa-rugosa-f-alba scientific_name: Rosa rugosa f. alba year: 1784 bibliography: 'J.A.Murray, Syst. Veg., ed. 14: 473 (1784)' author: Thunb. status: unknown rank: form family_common_name: Rose family genus_id: 5912 image_url: synonyms: [] genus: Rosa family: Rosaceae links: self: "/api/v1/species/rosa-rugosa-f-alba" plant: "/api/v1/plants/rosa-rugosa" genus: "/api/v1/genus/rosa" links: self: "/api/v1/species" first: "/api/v1/species?page=1" last: "/api/v1/species?page=1" meta: total: 9 '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/species/{id}": get: summary: Retrieve a species tags: - Species description: Get a species operationId: getSpecies parameters: - name: id required: true in: path description: The id or the slug of the requested species schema: type: string security: - token: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: "$ref": "#/components/schemas/species" meta: type: object properties: last_modified: type: string images_count: type: integer sources_count: type: integer synonyms_count: type: integer examples: returns-a-200-response: value: data: id: 170054 common_name: white poplar slug: populus-alba scientific_name: Populus alba year: 1753 bibliography: 'Sp. Pl.: 1034 (1753)' author: L. status: accepted rank: species family_common_name: Willow family genus_id: 5568 observations: C. & S. Europe to NW. China image_url: https://bs.floristic.org/image/o/fae7ede0f0fb6e7fd6c57c7f48c93af9262cb13a genus: Populus family: Salicaceae duration: images: flower: - id: 3364540 image_url: https://bs.floristic.org/image/o/e79211219db9463dea30e7c12ef37c94ea9be897 copyright: Taken Mar 22, 2018 by Jordi Riera (cc-by-sa) - id: 3364541 image_url: https://bs.floristic.org/image/o/8790bd993b39022371099c33471486696662c3d2 copyright: Taken Nov 7, 2019 by Medrano Alvaro (cc-by-sa) - id: 3364542 image_url: https://bs.floristic.org/image/o/9175f957aa09b1b67831c551b081d68d79664d8c copyright: Taken Jun 1, 2017 by Cruz Fer (cc-by-sa) - id: 3364543 image_url: https://bs.floristic.org/image/o/ee12297b319008ae9c1b8d464ed04496aca42d48 copyright: Taken Mar 26, 2018 by francois tissot (cc-by-sa) - id: 3364544 image_url: https://bs.floristic.org/image/o/61ecf1d96689ef3ad9adfc52d9032a831ecf85c4 copyright: Taken Jun 1, 2017 by Cruz Fer (cc-by-sa) - id: 3556753 image_url: https://bs.floristic.org/image/o/8614339dc35bd27fa335a5ffb626a79a12364782 copyright: Taken Jul 7, 2020 by catherine chauffray (cc-by-sa) leaf: - id: 3364550 image_url: https://bs.floristic.org/image/o/5eb606754be1f23e47d91c1a4099b06e00ee764d copyright: Taken Sep 28, 2019 by elena (cc-by-sa) - id: 3364551 image_url: https://bs.floristic.org/image/o/85f208afcc9843a9f42258444b62bee6ba0de2d2 copyright: Taken Jun 25, 2019 by liocam (cc-by-sa) - id: 3364552 image_url: https://bs.floristic.org/image/o/ee08f7f0be9a5b2668c9854f4cb59d654d18bf8b copyright: Taken Oct 12, 2017 by Lou Vandaele (cc-by-sa) - id: 3364553 image_url: https://bs.floristic.org/image/o/cad997e94dd64bf32d8e46d9e8c3e8fc57be1931 copyright: Taken Sep 1, 2019 by zef (cc-by-sa) - id: 3364554 image_url: https://bs.floristic.org/image/o/204214db34ac0ebfbffbfeb87a1bce613c9140f5 copyright: Taken May 18, 2017 by Philippe Feldmann (cc-by-sa) - id: 3556755 image_url: https://bs.floristic.org/image/o/689f2cd4243ef219309105177fc7766e940e5b92 copyright: Taken Sep 28, 2019 by elena (cc-by-sa) habit: - id: 3364559 image_url: https://bs.floristic.org/image/o/fae7ede0f0fb6e7fd6c57c7f48c93af9262cb13a copyright: Taken Sep 1, 2019 by zef (cc-by-sa) - id: 3364555 image_url: https://bs.floristic.org/image/o/fecf6a3ae03c461778921e59c0cca8fb6a617b8b copyright: Taken Apr 22, 2020 by Juni (cc-by-sa) - id: 3364556 image_url: https://bs.floristic.org/image/o/79b2764048e85e66c87450acfe35829c635f7be3 copyright: Taken Dec 2, 2019 by Kampf Robert (cc-by-sa) - id: 3364557 image_url: https://bs.floristic.org/image/o/c398cf3a6b0bb6d6c5c41482763dd409d7de89ca copyright: Taken Aug 15, 2019 by Jiří Vilím (cc-by-sa) - id: 3364558 image_url: https://bs.floristic.org/image/o/ad493224532eed7595d6898a99f1efc1317416e3 copyright: Taken Oct 15, 2019 by Werner Rom (cc-by-sa) fruit: - id: 3364561 image_url: https://bs.floristic.org/image/o/9f288fdcc627ba9d283cdb619da6dc12c0b5e8ba copyright: Taken Oct 5, 2019 by Mihai rad (cc-by-sa) - id: 3364562 image_url: https://bs.floristic.org/image/o/13b6317c3d9807155858366098b47789faad734a copyright: Taken Apr 24, 2020 by Dieter Wagner (cc-by-sa) - id: 3364563 image_url: https://bs.floristic.org/image/o/124c356132a598108c35cc1b53d27a58502d16fa copyright: Taken Apr 24, 2020 by Dieter Wagner (cc-by-sa) - id: 3364564 image_url: https://bs.floristic.org/image/o/c4b56eb13e6de9cca0133bab6eea091830ba9866 copyright: Taken Apr 24, 2020 by Dieter Wagner (cc-by-sa) - id: 3364565 image_url: https://bs.floristic.org/image/o/823cceb4c01e7c532bc8394a01413bfff41da38b copyright: Taken May 4, 2019 by Marek Jancák (cc-by-sa) bark: - id: 3364545 image_url: https://bs.floristic.org/image/o/028cecc74b14805f7aaef78da53b9556eb8f946e copyright: Taken Dec 7, 2016 by Marta Valencia (cc-by-sa) - id: 3364546 image_url: https://bs.floristic.org/image/o/28635066aaf5a191d0ac6658147c1f61ff791ce6 copyright: Taken May 4, 2019 by Marek Jancák (cc-by-sa) - id: 3364547 image_url: https://bs.floristic.org/image/o/fd48aec74d25715b7402ed9feca3d1a730287d0f copyright: Taken Oct 4, 2019 by monique exbrayat (cc-by-sa) - id: 3364548 image_url: https://bs.floristic.org/image/o/32730db42475fba90608129c6ff86ba67f8820d8 copyright: Taken Dec 8, 2019 by fabio (cc-by-sa) - id: 3364549 image_url: https://bs.floristic.org/image/o/88260defd473dd00f39487533b2a575aa13f24a1 copyright: Taken Dec 8, 2019 by fabio (cc-by-sa) other: - id: 3364566 image_url: https://bs.floristic.org/image/o/fa4d75e768d12d95b7dbdfef63ef52a77b65acde copyright: Taken Oct 7, 2014 by Tela Botanica − Liliane Roubaudi (cc-by-sa) - id: 3364567 image_url: https://bs.floristic.org/image/o/9718b5550d31c85fa361da72e5bbc880cbd3c079 copyright: Taken Oct 7, 2014 by Tela Botanica − Liliane Roubaudi (cc-by-sa) - id: 3364568 image_url: https://bs.floristic.org/image/o/c3cdbf5f84b2e0e6e6d62d871c8523696aaa43be copyright: Taken Jun 10, 2013 by Tela Botanica − daniel BARTHELEMY (cc-by-sa) - id: 3364569 image_url: https://bs.floristic.org/image/o/e0bd8dfa825a611ea524001dcc342a263b9fceea copyright: Taken Jun 10, 2013 by Tela Botanica − daniel BARTHELEMY (cc-by-sa) - id: 3364570 image_url: https://bs.floristic.org/image/o/f5039904c971b00c491235d194a0d59729679052 copyright: Taken Jun 10, 2013 by Tela Botanica − daniel BARTHELEMY (cc-by-sa) common_names: en: - Silverleaf poplar - Abele - White poplar - Silver poplar - European white poplar - Silber-Pappel - Witte abeel - Lamo blanco - Lamo - Lber - Silver-leaved poplar - Silver-leaf Poplar - Abele Tree - Gin-doro - Xin bai yang af: - Witpopulier sq: - Plepi i bardhë ar: - حور أبيض hy: - Բարդի սպիտակ av: - ХахIцIул az: - Ağcaqovaq (bitki) eu: - Zurzuri bg: - Бяла топола ca: - Àlber - Poll blanc - Popul blanc zh: - Xin bai yang co: - Albaru hr: - Bijela topola cs: - Topol bílý - Linda da: - Sølv-Poppel nl: - Witte abeel eo: - Blanka poplo et: - Hõbepappel - Hõbehaab fi: - Hopeapoppeli - Hopeahaapa fr: - Peuplier blanc - Abèle - Peuplier argenté - Peuplier blanc de Hollande - Peuplier à feuille d'érable - Peuplier de Hollande - Peuplier grisard - Peuplier gris de l'Oise gl: - Álamo Branco de: - Silber-Pappel - Silberpappel - Weißpappel hu: - Fehér nyár is: - Silfurösp ga: - Poibleog gheal it: - Pioppo bianco - Gattice ja: - Gin-doro - Urajiro-hako-yanagi - Hakuyō - ギンドロ kk: - Ақ терек ko: - Eunbaegyang lv: - Baltā apse - Balt lt: - Baltoji tuopa nb: - Sølvpoppel nn: - Sølvpoppel oc: - Albar fa: - سپیدار سفید pl: - Topola biała pt: - Choupo-branco ro: - Plop alb ru: - Topol' serebristyj - Тополь белый sc: - Fustialvu sr: - Бела топола sk: - Topoľ biely sl: - Beli topol es: - Álamo blanco - Alamo-blanco - Chopo blanco - Populus alba - Alamo blanco sv: - Silverpoppel - Hopeapoppeli - Vitpoppel tr: - Ak kavak uk: - Тополя біла cy: - Poplysen wen lit: - baltoji tuopa por: - choupo-branco - álamo-branco - álamo-prateado deu: - silber-pappel dan: - sølv-poppel eng: - white poplar - abele - silver poplar - silverleaf poplar - european white poplar - silver-leaved poplar nld: - witte abeel spa: - alamo-blanco - álamo blanco lav: - balt fin: - hopeapoppeli swe: - hopeapoppeli - silverpoppel - vitpoppel est: - hõbehaab fra: - peuplier blanc - abèle - peuplier argenté - peuplier blanc de hollande - peuplier à feuille d'érable nno: - sølvpoppel nob: - sølvpoppel afr: - witpopulier distribution: native: - Albania - Algeria - Altay - Austria - Bulgaria - Central European Rus - Corse - Czechoslovakia - East Aegean Is. - East European Russia - France - Germany - Greece - Hungary - Italy - Kazakhstan - Kriti - Lebanon-Syria - Libya - Morocco - Poland - Portugal - Romania - Sardegna - Sicilia - South European Russi - Spain - Switzerland - Tunisia - Turkey - Turkmenistan - Ukraine - Xinjiang - Yugoslavia introduced: - Alabama - Argentina Northeast - Argentina South - Azores - Baleares - Baltic States - Belgium - Bolivia - Canary Is. - China North-Central - China Southeast - Colorado - Cyprus - Denmark - Falkland Is. - Free State - Great Britain - Guatemala - Illinois - Inner Mongolia - Iraq - Ireland - Japan - Kentucky - Korea - Krasnoyarsk - Lesotho - Madeira - Manchuria - Mexico Southwest - Netherlands - New Mexico - New York - North European Russi - Northern Provinces - Northwest European R - Palestine - Qinghai - Rwanda - St.Helena - Sweden - Tennessee - Vermont distributions: native: - id: 93 name: Albania slug: albania tdwg_code: ALB tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/albania" plants: "/api/v1/distributions/albania/plants" species: "/api/v1/distributions/albania/species" - id: 137 name: Algeria slug: algeria tdwg_code: ALG tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/algeria" plants: "/api/v1/distributions/algeria/plants" species: "/api/v1/distributions/algeria/species" - id: 303 name: Altay slug: altay tdwg_code: ALT tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/altay" plants: "/api/v1/distributions/altay/plants" species: "/api/v1/distributions/altay/species" - id: 275 name: Austria slug: austria tdwg_code: AUT tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/austria" plants: "/api/v1/distributions/austria/plants" species: "/api/v1/distributions/austria/species" - id: 94 name: Bulgaria slug: bulgaria tdwg_code: BUL tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/bulgaria" plants: "/api/v1/distributions/bulgaria/plants" species: "/api/v1/distributions/bulgaria/species" - id: 279 name: Central European Rus slug: central-european-rus tdwg_code: RUC tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/central-european-rus" plants: "/api/v1/distributions/central-european-rus/plants" species: "/api/v1/distributions/central-european-rus/species" - id: 125 name: Corse slug: corse tdwg_code: COR tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/corse" plants: "/api/v1/distributions/corse/plants" species: "/api/v1/distributions/corse/species" - id: 99 name: Czechoslovakia slug: czechoslovakia tdwg_code: CZE tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/czechoslovakia" plants: "/api/v1/distributions/czechoslovakia/plants" species: "/api/v1/distributions/czechoslovakia/species" - id: 118 name: East Aegean Is. slug: east-aegean-is tdwg_code: EAI tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/east-aegean-is" plants: "/api/v1/distributions/east-aegean-is/plants" species: "/api/v1/distributions/east-aegean-is/species" - id: 281 name: East European Russia slug: east-european-russia tdwg_code: RUE tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/east-european-russia" plants: "/api/v1/distributions/east-european-russia/plants" species: "/api/v1/distributions/east-european-russia/species" - id: 126 name: France slug: france tdwg_code: FRA tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/france" plants: "/api/v1/distributions/france/plants" species: "/api/v1/distributions/france/species" - id: 284 name: Germany slug: germany tdwg_code: GER tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/germany" plants: "/api/v1/distributions/germany/plants" species: "/api/v1/distributions/germany/species" - id: 95 name: Greece slug: greece tdwg_code: GRC tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/greece" plants: "/api/v1/distributions/greece/plants" species: "/api/v1/distributions/greece/species" - id: 285 name: Hungary slug: hungary tdwg_code: HUN tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/hungary" plants: "/api/v1/distributions/hungary/plants" species: "/api/v1/distributions/hungary/species" - id: 119 name: Italy slug: italy tdwg_code: ITA tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/italy" plants: "/api/v1/distributions/italy/plants" species: "/api/v1/distributions/italy/species" - id: 267 name: Kazakhstan slug: kazakhstan tdwg_code: KAZ tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/kazakhstan" plants: "/api/v1/distributions/kazakhstan/plants" species: "/api/v1/distributions/kazakhstan/species" - id: 128 name: Kriti slug: kriti tdwg_code: KRI tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/kriti" plants: "/api/v1/distributions/kriti/plants" species: "/api/v1/distributions/kriti/species" - id: 109 name: Lebanon-Syria slug: lebanon-syria tdwg_code: LBS tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/lebanon-syria" plants: "/api/v1/distributions/lebanon-syria/plants" species: "/api/v1/distributions/lebanon-syria/species" - id: 269 name: Libya slug: libya tdwg_code: LBY tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/libya" plants: "/api/v1/distributions/libya/plants" species: "/api/v1/distributions/libya/species" - id: 131 name: Morocco slug: morocco tdwg_code: MOR tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/morocco" plants: "/api/v1/distributions/morocco/plants" species: "/api/v1/distributions/morocco/species" - id: 292 name: Poland slug: poland tdwg_code: POL tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/poland" plants: "/api/v1/distributions/poland/plants" species: "/api/v1/distributions/poland/species" - id: 134 name: Portugal slug: portugal tdwg_code: POR tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/portugal" plants: "/api/v1/distributions/portugal/plants" species: "/api/v1/distributions/portugal/species" - id: 96 name: Romania slug: romania tdwg_code: ROM tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/romania" plants: "/api/v1/distributions/romania/plants" species: "/api/v1/distributions/romania/species" - id: 120 name: Sardegna slug: sardegna tdwg_code: SAR tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/sardegna" plants: "/api/v1/distributions/sardegna/plants" species: "/api/v1/distributions/sardegna/species" - id: 121 name: Sicilia slug: sicilia tdwg_code: SIC tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/sicilia" plants: "/api/v1/distributions/sicilia/plants" species: "/api/v1/distributions/sicilia/species" - id: 270 name: South European Russi slug: south-european-russi tdwg_code: RUS tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/south-european-russi" plants: "/api/v1/distributions/south-european-russi/plants" species: "/api/v1/distributions/south-european-russi/species" - id: 135 name: Spain slug: spain tdwg_code: SPA tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/spain" plants: "/api/v1/distributions/spain/plants" species: "/api/v1/distributions/spain/species" - id: 294 name: Switzerland slug: switzerland tdwg_code: SWI tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/switzerland" plants: "/api/v1/distributions/switzerland/plants" species: "/api/v1/distributions/switzerland/species" - id: 295 name: Tunisia slug: tunisia tdwg_code: TUN tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/tunisia" plants: "/api/v1/distributions/tunisia/plants" species: "/api/v1/distributions/tunisia/species" - id: 107 name: Turkey slug: turkey tdwg_code: TUR tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/turkey" plants: "/api/v1/distributions/turkey/plants" species: "/api/v1/distributions/turkey/species" - id: 337 name: Turkmenistan slug: turkmenistan tdwg_code: TKM tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/turkmenistan" plants: "/api/v1/distributions/turkmenistan/plants" species: "/api/v1/distributions/turkmenistan/species" - id: 273 name: Ukraine slug: ukraine tdwg_code: UKR tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/ukraine" plants: "/api/v1/distributions/ukraine/plants" species: "/api/v1/distributions/ukraine/species" - id: 324 name: Xinjiang slug: xinjiang tdwg_code: CHX tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/xinjiang" plants: "/api/v1/distributions/xinjiang/plants" species: "/api/v1/distributions/xinjiang/species" - id: 98 name: Yugoslavia slug: yugoslavia tdwg_code: YUG tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/yugoslavia" plants: "/api/v1/distributions/yugoslavia/plants" species: "/api/v1/distributions/yugoslavia/species" introduced: - id: 144 name: Alabama slug: alabama tdwg_code: ALA tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/alabama" plants: "/api/v1/distributions/alabama/plants" species: "/api/v1/distributions/alabama/species" - id: 169 name: Argentina Northeast slug: argentina-northeast tdwg_code: AGE tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/argentina-northeast" plants: "/api/v1/distributions/argentina-northeast/plants" species: "/api/v1/distributions/argentina-northeast/species" - id: 264 name: Argentina South slug: argentina-south tdwg_code: AGS tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/argentina-south" plants: "/api/v1/distributions/argentina-south/plants" species: "/api/v1/distributions/argentina-south/species" - id: 122 name: Azores slug: azores tdwg_code: AZO tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/azores" plants: "/api/v1/distributions/azores/plants" species: "/api/v1/distributions/azores/species" - id: 123 name: Baleares slug: baleares tdwg_code: BAL tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/baleares" plants: "/api/v1/distributions/baleares/plants" species: "/api/v1/distributions/baleares/species" - id: 276 name: Baltic States slug: baltic-states tdwg_code: BLT tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/baltic-states" plants: "/api/v1/distributions/baltic-states/plants" species: "/api/v1/distributions/baltic-states/species" - id: 278 name: Belgium slug: belgium tdwg_code: BGM tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/belgium" plants: "/api/v1/distributions/belgium/plants" species: "/api/v1/distributions/belgium/species" - id: 77 name: Bolivia slug: bolivia tdwg_code: BOL tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/bolivia" plants: "/api/v1/distributions/bolivia/plants" species: "/api/v1/distributions/bolivia/species" - id: 124 name: Canary Is. slug: canary-is tdwg_code: CNY tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/canary-is" plants: "/api/v1/distributions/canary-is/plants" species: "/api/v1/distributions/canary-is/species" - id: 249 name: China North-Central slug: china-north-central tdwg_code: CHN tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/china-north-central" plants: "/api/v1/distributions/china-north-central/plants" species: "/api/v1/distributions/china-north-central/species" - id: 46 name: China Southeast slug: china-southeast tdwg_code: CHS tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/china-southeast" plants: "/api/v1/distributions/china-southeast/plants" species: "/api/v1/distributions/china-southeast/species" - id: 298 name: Colorado slug: colorado tdwg_code: COL tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/colorado" plants: "/api/v1/distributions/colorado/plants" species: "/api/v1/distributions/colorado/species" - id: 266 name: Cyprus slug: cyprus tdwg_code: CYP tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/cyprus" plants: "/api/v1/distributions/cyprus/plants" species: "/api/v1/distributions/cyprus/species" - id: 280 name: Denmark slug: denmark tdwg_code: DEN tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/denmark" plants: "/api/v1/distributions/denmark/plants" species: "/api/v1/distributions/denmark/species" - id: 345 name: Falkland Is. slug: falkland-is tdwg_code: FAL tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/falkland-is" plants: "/api/v1/distributions/falkland-is/plants" species: "/api/v1/distributions/falkland-is/species" - id: 90 name: Free State slug: free-state tdwg_code: OFS tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/free-state" plants: "/api/v1/distributions/free-state/plants" species: "/api/v1/distributions/free-state/species" - id: 127 name: Great Britain slug: great-britain tdwg_code: GRB tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/great-britain" plants: "/api/v1/distributions/great-britain/plants" species: "/api/v1/distributions/great-britain/species" - id: 156 name: Guatemala slug: guatemala tdwg_code: GUA tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/guatemala" plants: "/api/v1/distributions/guatemala/plants" species: "/api/v1/distributions/guatemala/species" - id: 145 name: Illinois slug: illinois tdwg_code: ILL tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/illinois" plants: "/api/v1/distributions/illinois/plants" species: "/api/v1/distributions/illinois/species" - id: 317 name: Inner Mongolia slug: inner-mongolia tdwg_code: CHI tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/inner-mongolia" plants: "/api/v1/distributions/inner-mongolia/plants" species: "/api/v1/distributions/inner-mongolia/species" - id: 108 name: Iraq slug: iraq tdwg_code: IRQ tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/iraq" plants: "/api/v1/distributions/iraq/plants" species: "/api/v1/distributions/iraq/species" - id: 286 name: Ireland slug: ireland tdwg_code: IRE tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/ireland" plants: "/api/v1/distributions/ireland/plants" species: "/api/v1/distributions/ireland/species" - id: 202 name: Japan slug: japan tdwg_code: JAP tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/japan" plants: "/api/v1/distributions/japan/plants" species: "/api/v1/distributions/japan/species" - id: 146 name: Kentucky slug: kentucky tdwg_code: KTY tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/kentucky" plants: "/api/v1/distributions/kentucky/plants" species: "/api/v1/distributions/kentucky/species" - id: 226 name: Korea slug: korea tdwg_code: KOR tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/korea" plants: "/api/v1/distributions/korea/plants" species: "/api/v1/distributions/korea/species" - id: 309 name: Krasnoyarsk slug: krasnoyarsk tdwg_code: KRA tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/krasnoyarsk" plants: "/api/v1/distributions/krasnoyarsk/plants" species: "/api/v1/distributions/krasnoyarsk/species" - id: 222 name: Lesotho slug: lesotho tdwg_code: LES tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/lesotho" plants: "/api/v1/distributions/lesotho/plants" species: "/api/v1/distributions/lesotho/species" - id: 129 name: Madeira slug: madeira tdwg_code: MDR tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/madeira" plants: "/api/v1/distributions/madeira/plants" species: "/api/v1/distributions/madeira/species" - id: 310 name: Manchuria slug: manchuria tdwg_code: CHM tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/manchuria" plants: "/api/v1/distributions/manchuria/plants" species: "/api/v1/distributions/manchuria/species" - id: 88 name: Mexico Southwest slug: mexico-southwest tdwg_code: MXS tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/mexico-southwest" plants: "/api/v1/distributions/mexico-southwest/plants" species: "/api/v1/distributions/mexico-southwest/species" - id: 287 name: Netherlands slug: netherlands tdwg_code: NET tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/netherlands" plants: "/api/v1/distributions/netherlands/plants" species: "/api/v1/distributions/netherlands/species" - id: 167 name: New Mexico slug: new-mexico tdwg_code: NWM tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/new-mexico" plants: "/api/v1/distributions/new-mexico/plants" species: "/api/v1/distributions/new-mexico/species" - id: 237 name: New York slug: new-york tdwg_code: NWY tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/new-york" plants: "/api/v1/distributions/new-york/plants" species: "/api/v1/distributions/new-york/species" - id: 289 name: North European Russi slug: north-european-russi tdwg_code: RUN tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/north-european-russi" plants: "/api/v1/distributions/north-european-russi/plants" species: "/api/v1/distributions/north-european-russi/species" - id: 1 name: Northern Provinces slug: northern-provinces tdwg_code: TVL tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/northern-provinces" plants: "/api/v1/distributions/northern-provinces/plants" species: "/api/v1/distributions/northern-provinces/species" - id: 290 name: Northwest European R slug: northwest-european-r tdwg_code: RUW tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/northwest-european-r" plants: "/api/v1/distributions/northwest-european-r/plants" species: "/api/v1/distributions/northwest-european-r/species" - id: 117 name: Palestine slug: palestine tdwg_code: PAL tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/palestine" plants: "/api/v1/distributions/palestine/plants" species: "/api/v1/distributions/palestine/species" - id: 322 name: Qinghai slug: qinghai tdwg_code: CHQ tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/qinghai" plants: "/api/v1/distributions/qinghai/plants" species: "/api/v1/distributions/qinghai/species" - id: 68 name: Rwanda slug: rwanda tdwg_code: RWA tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/rwanda" plants: "/api/v1/distributions/rwanda/plants" species: "/api/v1/distributions/rwanda/species" - id: 184 name: St.Helena slug: st-helena tdwg_code: STH tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/st-helena" plants: "/api/v1/distributions/st-helena/plants" species: "/api/v1/distributions/st-helena/species" - id: 293 name: Sweden slug: sweden tdwg_code: SWE tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/sweden" plants: "/api/v1/distributions/sweden/plants" species: "/api/v1/distributions/sweden/species" - id: 149 name: Tennessee slug: tennessee tdwg_code: TEN tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/tennessee" plants: "/api/v1/distributions/tennessee/plants" species: "/api/v1/distributions/tennessee/species" - id: 243 name: Vermont slug: vermont tdwg_code: VER tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/vermont" plants: "/api/v1/distributions/vermont/plants" species: "/api/v1/distributions/vermont/species" flower: color: conspicuous: false foliage: texture: coarse color: leaf_retention: false fruit_or_seed: conspicuous: true color: shape: seed_persistence: false specifications: ligneous_type: tree growth_form: Single Stem growth_habit: Tree growth_rate: Rapid average_height: cm: 3048 maximum_height: cm: 3048 nitrogen_fixation: None shape_and_orientation: Erect toxicity: none growth: description: sowing: days_to_harvest: row_spacing: cm: spread: cm: ph_maximum: 7.0 ph_minimum: 4.9 light: 8 atmospheric_humidity: 8 growth_months: bloom_months: fruit_months: minimum_precipitation: mm: 609 maximum_precipitation: mm: 1397 minimum_root_depth: cm: 60 minimum_temperature: deg_f: -38 deg_c: -38 maximum_temperature: deg_f: deg_c: soil_nutriments: 7 soil_salinity: 0 soil_texture: 1 soil_humidity: links: self: "/api/v1/species/populus-alba" plant: "/api/v1/plants/populus-alba" genus: "/api/v1/genus/populus" synonyms: - id: 23739 name: Populus hybrida author: M.Bieb. sources: [] - id: 583553 name: Populus hickeliana author: Dode sources: [] - id: 583554 name: Populus bachofenii author: Wierzb. ex Rchb. sources: [] - id: 583555 name: Populus aegyptiaca author: W.Baxter sources: [] - id: 583556 name: Populus caspica author: "(Bornm.) Bornm." sources: [] - id: 583557 name: Populus nivea author: "(Aiton) Willd." sources: [] - id: 583558 name: Populus bolleana author: Carrière sources: [] - id: 583559 name: Populus major author: Mill. sources: [] - id: 583560 name: Leuce alba author: "(L.) Opiz" sources: [] - id: 583561 name: Populus berkarensis author: Poljakov sources: [] - id: 638377 name: Populus alba var. bolleana author: Lauche sources: [] sources: - last_update: '2020-06-21T20:38:54.000Z' id: POAL7 name: USDA url: https://plants.usda.gov/core/profile?symbol=POAL7 citation: https://plants.sc.egov.usda.gov/core/profile?symbol=POAL7 - last_update: '2020-07-04T19:20:53.000Z' id: 16/8.0.2.0.1 name: CATMINAT url: citation: - last_update: '2020-06-17T02:28:44.000Z' id: Populus alba L. name: PlantNet url: https://identify.plantnet.org/species/the-plant-list/Populus alba L. citation: - last_update: '2020-06-17T02:28:44.000Z' id: '3040233' name: GBIF url: https://www.gbif.org/species/3040233 citation: - last_update: '2020-07-18T06:49:02.000Z' id: urn:lsid:ipni.org:names:776573-1 name: POWO url: http://powo.science.kew.org/taxon/urn:lsid:ipni.org:names:776573-1 citation: POWO (2019). Plants of the World Online. Facilitated by the Royal Botanic Gardens, Kew. Published on the Internet; http://www.plantsoftheworldonline.org/ Retrieved 2020-07-18 meta: images_count: 35 sources_count: 5 synonyms_count: 11 last_modified: '2020-08-11T16:23:04.199Z' '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/species/search": get: summary: Search for a species tags: - Species description: Search for a species with the given scientific name, common name, synonym name etc. operationId: searchSpecies parameters: - name: q required: true in: query description: The string to search schema: type: string - name: page in: query required: false description: The page to fetch schema: type: number - name: filter in: query required: false type: object description: Filter on values schema: "$ref": "#/components/schemas/filters_species" - name: filter_not in: query required: false type: object description: Exclude results matching null values schema: "$ref": "#/components/schemas/filters_not_species" - name: order in: query required: false type: object description: Sort on values schema: "$ref": "#/components/schemas/sorts_species" - name: range in: query required: false type: object description: Range on values schema: "$ref": "#/components/schemas/ranges_species" security: - token: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: "$ref": "#/components/schemas/species_light" links: type: object properties: self: type: string description: A link to the current page of the collection first: type: string description: A link to the first page of the collection next: type: string description: A link to the next page of the collection prev: type: string description: A link to the previous page of the collection last: type: string description: A link to the last page of the collection required: - self meta: type: object properties: total: type: integer examples: returns-a-200-response: value: data: [] links: self: "/api/v1/species/search?q=cocos" first: "/api/v1/species/search?page=1&q=cocos" last: "/api/v1/species/search?page=1&q=cocos" meta: total: 0 "/api/v1/species/{id}/report": post: summary: Report an error tags: - Species description: A short API call to report an error regarding a species entry operationId: reportSpecies parameters: - name: id required: true in: path description: The id or the slug of the requested species schema: type: string security: - token: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: "$ref": "#/components/schemas/correction" meta: type: object properties: last_modified: type: string examples: returns-a-200-response: value: data: id: 2 record_type: Species record_id: 170054 user_id: 25 warning_type: report change_status: pending change_type: update accepted_by: notes: The flower color is red created_at: '2020-08-11T16:23:09.960Z' updated_at: '2020-08-11T16:23:09.961Z' correction: changes: meta: last_modified: '2020-08-11T16:23:09.961Z' '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token requestBody: content: application/json: schema: type: object properties: notes: type: string example: The flower color is red description: An optional note about the incorrect data "/api/v1/distributions": get: summary: List distributions zones tags: - Distributions description: | List distributions zones. Zones are following the WGSRPD convention. WGSRPD provides an agreed system of geographical units at approximately "country" level and upwards for use in recording plant distributions. It allows adopting organizations to compare and exchange data with each other without loss of information due to incompatible geographical boundaries. [Read more on the TDWG website](https://www.tdwg.org/standards/wgsrpd/). operationId: listDistributions security: - token: [] parameters: - name: page in: query required: false description: The page to fetch schema: type: number responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: "$ref": "#/components/schemas/zone" links: type: object properties: self: type: string description: A link to the current page of the collection first: type: string description: A link to the first page of the collection next: type: string description: A link to the next page of the collection prev: type: string description: A link to the previous page of the collection last: type: string description: A link to the last page of the collection required: - self meta: type: object properties: total: type: integer examples: returns-a-200-response: value: data: - id: 446 name: Abkhaziya slug: abkhaziya tdwg_code: TCS-AB tdwg_level: 4 species_count: 0 links: self: "/api/v1/distributions/abkhaziya" plants: "/api/v1/distributions/abkhaziya/plants" species: "/api/v1/distributions/abkhaziya/species" parent: id: 272 name: Transcaucasus slug: transcaucasus tdwg_code: TCS tdwg_level: 3 species_count: 0 links: self: "/api/v1/distributions/transcaucasus" plants: "/api/v1/distributions/transcaucasus/plants" species: "/api/v1/distributions/transcaucasus/species" children: [] - id: 694 name: Acre slug: acre tdwg_code: BZN-AC tdwg_level: 4 species_count: 0 links: self: "/api/v1/distributions/acre" plants: "/api/v1/distributions/acre/plants" species: "/api/v1/distributions/acre/species" parent: id: 78 name: Brazil North slug: brazil-north tdwg_code: BZN tdwg_level: 3 species_count: 0 links: self: "/api/v1/distributions/brazil-north" plants: "/api/v1/distributions/brazil-north/plants" species: "/api/v1/distributions/brazil-north/species" children: [] - id: 447 name: Adzhariya slug: adzhariya tdwg_code: TCS-AD tdwg_level: 4 species_count: 0 links: self: "/api/v1/distributions/adzhariya" plants: "/api/v1/distributions/adzhariya/plants" species: "/api/v1/distributions/adzhariya/species" parent: id: 272 name: Transcaucasus slug: transcaucasus tdwg_code: TCS tdwg_level: 3 species_count: 0 links: self: "/api/v1/distributions/transcaucasus" plants: "/api/v1/distributions/transcaucasus/plants" species: "/api/v1/distributions/transcaucasus/species" children: [] - id: 151 name: Afghanistan slug: afghanistan tdwg_code: AFG tdwg_level: 3 species_count: 0 links: self: "/api/v1/distributions/afghanistan" plants: "/api/v1/distributions/afghanistan/plants" species: "/api/v1/distributions/afghanistan/species" parent: id: 453 name: Western Asia slug: western-asia tdwg_code: '34' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/western-asia" plants: "/api/v1/distributions/western-asia/plants" species: "/api/v1/distributions/western-asia/species" children: [] - id: 407 name: Africa slug: africa tdwg_code: '2' tdwg_level: 1 species_count: 0 links: self: "/api/v1/distributions/africa" plants: "/api/v1/distributions/africa/plants" species: "/api/v1/distributions/africa/species" parent: children: - id: 408 name: Northern Africa slug: northern-africa tdwg_code: '20' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/northern-africa" plants: "/api/v1/distributions/northern-africa/plants" species: "/api/v1/distributions/northern-africa/species" - id: 411 name: Macaronesia slug: macaronesia tdwg_code: '21' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/macaronesia" plants: "/api/v1/distributions/macaronesia/plants" species: "/api/v1/distributions/macaronesia/species" - id: 412 name: West Tropical Africa slug: west-tropical-africa tdwg_code: '22' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/west-tropical-africa" plants: "/api/v1/distributions/west-tropical-africa/plants" species: "/api/v1/distributions/west-tropical-africa/species" - id: 413 name: West-Central Tropical Africa slug: west-central-tropical-africa tdwg_code: '23' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/west-central-tropical-africa" plants: "/api/v1/distributions/west-central-tropical-africa/plants" species: "/api/v1/distributions/west-central-tropical-africa/species" - id: 418 name: Northeast Tropical Africa slug: northeast-tropical-africa tdwg_code: '24' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/northeast-tropical-africa" plants: "/api/v1/distributions/northeast-tropical-africa/plants" species: "/api/v1/distributions/northeast-tropical-africa/species" - id: 419 name: East Tropical Africa slug: east-tropical-africa tdwg_code: '25' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/east-tropical-africa" plants: "/api/v1/distributions/east-tropical-africa/plants" species: "/api/v1/distributions/east-tropical-africa/species" - id: 420 name: South Tropical Africa slug: south-tropical-africa tdwg_code: '26' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/south-tropical-africa" plants: "/api/v1/distributions/south-tropical-africa/plants" species: "/api/v1/distributions/south-tropical-africa/species" - id: 421 name: Southern Africa slug: southern-africa tdwg_code: '27' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/southern-africa" plants: "/api/v1/distributions/southern-africa/plants" species: "/api/v1/distributions/southern-africa/species" - id: 429 name: Middle Atlantic Ocean slug: middle-atlantic-ocean tdwg_code: '28' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/middle-atlantic-ocean" plants: "/api/v1/distributions/middle-atlantic-ocean/plants" species: "/api/v1/distributions/middle-atlantic-ocean/species" - id: 430 name: Western Indian Ocean slug: western-indian-ocean tdwg_code: '29' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/western-indian-ocean" plants: "/api/v1/distributions/western-indian-ocean/plants" species: "/api/v1/distributions/western-indian-ocean/species" - id: 613 name: Aguascalientes slug: aguascalientes tdwg_code: MXE-AG tdwg_level: 4 species_count: 0 links: self: "/api/v1/distributions/aguascalientes" plants: "/api/v1/distributions/aguascalientes/plants" species: "/api/v1/distributions/aguascalientes/species" parent: id: 148 name: Mexico Northeast slug: mexico-northeast tdwg_code: MXE tdwg_level: 3 species_count: 0 links: self: "/api/v1/distributions/mexico-northeast" plants: "/api/v1/distributions/mexico-northeast/plants" species: "/api/v1/distributions/mexico-northeast/species" children: [] - id: 739 name: Aisen slug: aisen tdwg_code: CLS-AI tdwg_level: 4 species_count: 0 links: self: "/api/v1/distributions/aisen" plants: "/api/v1/distributions/aisen/plants" species: "/api/v1/distributions/aisen/species" parent: id: 333 name: Chile South slug: chile-south tdwg_code: CLS tdwg_level: 3 species_count: 0 links: self: "/api/v1/distributions/chile-south" plants: "/api/v1/distributions/chile-south/plants" species: "/api/v1/distributions/chile-south/species" children: [] - id: 144 name: Alabama slug: alabama tdwg_code: ALA tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/alabama" plants: "/api/v1/distributions/alabama/plants" species: "/api/v1/distributions/alabama/species" parent: id: 606 name: Southeastern U.S.A. slug: southeastern-u-s-a tdwg_code: '78' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/southeastern-u-s-a" plants: "/api/v1/distributions/southeastern-u-s-a/plants" species: "/api/v1/distributions/southeastern-u-s-a/species" children: [] - id: 679 name: Alagoas slug: alagoas tdwg_code: BZE-AL tdwg_level: 4 species_count: 0 links: self: "/api/v1/distributions/alagoas" plants: "/api/v1/distributions/alagoas/plants" species: "/api/v1/distributions/alagoas/species" parent: id: 79 name: Brazil Northeast slug: brazil-northeast tdwg_code: BZE tdwg_level: 3 species_count: 0 links: self: "/api/v1/distributions/brazil-northeast" plants: "/api/v1/distributions/brazil-northeast/plants" species: "/api/v1/distributions/brazil-northeast/species" children: [] - id: 325 name: Alaska slug: alaska tdwg_code: ASK tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/alaska" plants: "/api/v1/distributions/alaska/plants" species: "/api/v1/distributions/alaska/species" parent: id: 596 name: Subarctic America slug: subarctic-america tdwg_code: '70' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/subarctic-america" plants: "/api/v1/distributions/subarctic-america/plants" species: "/api/v1/distributions/subarctic-america/species" children: [] - id: 93 name: Albania slug: albania tdwg_code: ALB tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/albania" plants: "/api/v1/distributions/albania/plants" species: "/api/v1/distributions/albania/species" parent: id: 387 name: Southeastern Europe slug: southeastern-europe tdwg_code: '13' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/southeastern-europe" plants: "/api/v1/distributions/southeastern-europe/plants" species: "/api/v1/distributions/southeastern-europe/species" children: [] - id: 326 name: Alberta slug: alberta tdwg_code: ABT tdwg_level: 3 species_count: 0 links: self: "/api/v1/distributions/alberta" plants: "/api/v1/distributions/alberta/plants" species: "/api/v1/distributions/alberta/species" parent: id: 597 name: Western Canada slug: western-canada tdwg_code: '71' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/western-canada" plants: "/api/v1/distributions/western-canada/plants" species: "/api/v1/distributions/western-canada/species" children: [] - id: 212 name: Aldabra slug: aldabra tdwg_code: ALD tdwg_level: 3 species_count: 0 links: self: "/api/v1/distributions/aldabra" plants: "/api/v1/distributions/aldabra/plants" species: "/api/v1/distributions/aldabra/species" parent: id: 430 name: Western Indian Ocean slug: western-indian-ocean tdwg_code: '29' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/western-indian-ocean" plants: "/api/v1/distributions/western-indian-ocean/plants" species: "/api/v1/distributions/western-indian-ocean/species" children: [] - id: 356 name: Aleutian Is. slug: aleutian-is tdwg_code: ALU tdwg_level: 3 species_count: 0 links: self: "/api/v1/distributions/aleutian-is" plants: "/api/v1/distributions/aleutian-is/plants" species: "/api/v1/distributions/aleutian-is/species" parent: id: 596 name: Subarctic America slug: subarctic-america tdwg_code: '70' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/subarctic-america" plants: "/api/v1/distributions/subarctic-america/plants" species: "/api/v1/distributions/subarctic-america/species" children: [] - id: 137 name: Algeria slug: algeria tdwg_code: ALG tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/algeria" plants: "/api/v1/distributions/algeria/plants" species: "/api/v1/distributions/algeria/species" parent: id: 408 name: Northern Africa slug: northern-africa tdwg_code: '20' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/northern-africa" plants: "/api/v1/distributions/northern-africa/plants" species: "/api/v1/distributions/northern-africa/species" children: [] - id: 303 name: Altay slug: altay tdwg_code: ALT tdwg_level: 3 species_count: 2 links: self: "/api/v1/distributions/altay" plants: "/api/v1/distributions/altay/plants" species: "/api/v1/distributions/altay/species" parent: id: 434 name: Siberia slug: siberia tdwg_code: '30' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/siberia" plants: "/api/v1/distributions/siberia/plants" species: "/api/v1/distributions/siberia/species" children: [] - id: 696 name: Amapa slug: amapa tdwg_code: BZN-AP tdwg_level: 4 species_count: 0 links: self: "/api/v1/distributions/amapa" plants: "/api/v1/distributions/amapa/plants" species: "/api/v1/distributions/amapa/species" parent: id: 78 name: Brazil North slug: brazil-north tdwg_code: BZN tdwg_level: 3 species_count: 0 links: self: "/api/v1/distributions/brazil-north" plants: "/api/v1/distributions/brazil-north/plants" species: "/api/v1/distributions/brazil-north/species" children: [] - id: 695 name: Amazonas slug: amazonas tdwg_code: BZN-AM tdwg_level: 4 species_count: 0 links: self: "/api/v1/distributions/amazonas" plants: "/api/v1/distributions/amazonas/plants" species: "/api/v1/distributions/amazonas/species" parent: id: 78 name: Brazil North slug: brazil-north tdwg_code: BZN tdwg_level: 3 species_count: 0 links: self: "/api/v1/distributions/brazil-north" plants: "/api/v1/distributions/brazil-north/plants" species: "/api/v1/distributions/brazil-north/species" children: [] - id: 578 name: American Samoa slug: american-samoa tdwg_code: SAM-AS tdwg_level: 4 species_count: 0 links: self: "/api/v1/distributions/american-samoa" plants: "/api/v1/distributions/american-samoa/plants" species: "/api/v1/distributions/american-samoa/species" parent: id: 220 name: Samoa slug: samoa tdwg_code: SAM tdwg_level: 3 species_count: 0 links: self: "/api/v1/distributions/samoa" plants: "/api/v1/distributions/samoa/plants" species: "/api/v1/distributions/samoa/species" children: [] - id: 355 name: Amsterdam-St.Paul Is slug: amsterdam-st-paul-is tdwg_code: ASP tdwg_level: 3 species_count: 0 links: self: "/api/v1/distributions/amsterdam-st-paul-is" plants: "/api/v1/distributions/amsterdam-st-paul-is/plants" species: "/api/v1/distributions/amsterdam-st-paul-is/species" parent: id: 743 name: Subantarctic Islands slug: subantarctic-islands tdwg_code: '90' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/subantarctic-islands" plants: "/api/v1/distributions/subantarctic-islands/plants" species: "/api/v1/distributions/subantarctic-islands/species" children: [] links: self: "/api/v1/distributions" first: "/api/v1/distributions?page=1" next: "/api/v1/distributions?page=2" last: "/api/v1/distributions?page=37" meta: total: 726 '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/distributions/{id}": get: summary: Retrieve a distribution zone tags: - Distributions description: Get a zone operationId: getZone parameters: - name: id required: true in: path description: The id or the slug of the requested zone schema: type: string security: - token: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: "$ref": "#/components/schemas/zone" meta: type: object properties: last_modified: type: string examples: returns-a-200-response: value: data: id: 1 name: Northern Provinces slug: northern-provinces tdwg_code: TVL tdwg_level: 3 species_count: 1 links: self: "/api/v1/distributions/northern-provinces" plants: "/api/v1/distributions/northern-provinces/plants" species: "/api/v1/distributions/northern-provinces/species" parent: id: 421 name: Southern Africa slug: southern-africa tdwg_code: '27' tdwg_level: 2 species_count: 0 links: self: "/api/v1/distributions/southern-africa" plants: "/api/v1/distributions/southern-africa/plants" species: "/api/v1/distributions/southern-africa/species" children: - id: 425 name: Gauteng slug: gauteng tdwg_code: TVL-GA tdwg_level: 4 species_count: 0 links: self: "/api/v1/distributions/gauteng" plants: "/api/v1/distributions/gauteng/plants" species: "/api/v1/distributions/gauteng/species" - id: 426 name: Mpumalanga slug: mpumalanga tdwg_code: TVL-MP tdwg_level: 4 species_count: 0 links: self: "/api/v1/distributions/mpumalanga" plants: "/api/v1/distributions/mpumalanga/plants" species: "/api/v1/distributions/mpumalanga/species" - id: 427 name: Northern Province slug: northern-province tdwg_code: TVL-NP tdwg_level: 4 species_count: 0 links: self: "/api/v1/distributions/northern-province" plants: "/api/v1/distributions/northern-province/plants" species: "/api/v1/distributions/northern-province/species" - id: 428 name: North-West Province slug: north-west-province tdwg_code: TVL-NW tdwg_level: 4 species_count: 0 links: self: "/api/v1/distributions/north-west-province" plants: "/api/v1/distributions/north-west-province/plants" species: "/api/v1/distributions/north-west-province/species" meta: last_modified: '2020-08-11T16:23:02.620Z' '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/auth/claim": post: summary: Request a client-side token tags: - Auth description: 'If you need to perform client-side requests, you will have to request a client-side token from you backend, and get a JWT token from this API call in return. This token will be usable on the client side. This call need your secret access token, the url of the website the client side requests will come from and optionally the client IP address. ' operationId: claimClientSideToken security: - token: [] parameters: [] responses: '200': description: Success content: application/json: schema: type: object properties: expiration: type: string example: 07-13-2020 13:41 description: The expiration time of the token. After this time, you'll have to request a token again token: type: string example: eyJhbGciOiJIUzI1NaJ9.eyJ1c2VyX2lkIjoxMDYsIe9yaWdpbiI6Imh0dHA6Ly9wb2NhbGhvc3Q6MzIzMyIsImlwIjoiOjoxIiwiZXhwIjoxNTk0NjQwNTEzfQ.TyqKyKxwsnn7TZsLAfS8OTmTUPk87CSXlk6a2wQU9co description: The client-side access token, that you'll use instead of your access token in the `token` parameter examples: returns-a-200-response: value: token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoyOCwib3JpZ2luIjoiaHR0cDovL2xvY2FsaG9zdDoxMjM0IiwiaXAiOiI6OjEiLCJleHBpcmUiOiIyMDIwLTA4LTEyIDE4OjIzOjEwICswMjAwIiwiZXhwIjoxNTk3MjQ5MzkwfQ.xUDkfjdFh0DV1jMDgxzNTU5zowtVjJv2-TYcpJG0RgM expiration: '08-12-2020 18:23' '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token '422': description: Missing parameters content: application/json: examples: returns-a-422-response: value: error: true message: 'param is missing or the value is empty: origin' requestBody: content: application/json: schema: type: object properties: origin: type: string example: https://example.com description: The website url the API requests will come from ip: type: string nullable: true example: 12.23.34.45 description: The client IP required: - origin "/api/v1/corrections": get: summary: Searches corrections tags: - Corrections description: List corrections operationId: listCorrections security: - token: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: "$ref": "#/components/schemas/correction" links: type: object properties: self: type: string description: A link to the current page of the collection first: type: string description: A link to the first page of the collection next: type: string description: A link to the next page of the collection prev: type: string description: A link to the previous page of the collection last: type: string description: A link to the last page of the collection required: - self meta: type: object properties: total: type: integer examples: returns-a-200-response: value: data: - id: 4 record_type: Species record_id: 814834 user_id: 31 warning_type: change_status: pending change_type: update accepted_by: notes: Is the author okay ? created_at: '2020-08-11T16:23:10.220Z' updated_at: '2020-08-11T16:23:10.220Z' correction: changes: - id: 3 record_type: Species record_id: 170054 user_id: 30 warning_type: change_status: pending change_type: update accepted_by: notes: The height is wrong, it's way smaller created_at: '2020-08-11T16:23:10.212Z' updated_at: '2020-08-11T16:23:10.212Z' correction: scientific_name: Populus alba maximum_height_value: 1524 maximum_height_unit: cm changes: links: self: "/api/v1/corrections" first: "/api/v1/corrections?page=1" last: "/api/v1/corrections?page=1" meta: total: 2 '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/corrections/{id}": get: summary: Retrieve a correction tags: - Corrections description: Get a correction operationId: getCorrection parameters: - name: id required: true in: path description: The id of the requested correction schema: type: string security: - token: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: "$ref": "#/components/schemas/correction" meta: type: object properties: last_modified: type: string examples: returns-a-200-response: value: data: id: 7 record_type: Species record_id: 170054 user_id: 35 warning_type: change_status: pending change_type: update accepted_by: notes: The height is wrong, it's way smaller created_at: '2020-08-11T16:23:10.282Z' updated_at: '2020-08-11T16:23:10.282Z' correction: scientific_name: Populus alba maximum_height_value: 1524 maximum_height_unit: cm changes: meta: last_modified: '2020-08-11T16:23:10.282Z' '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token "/api/v1/corrections/species/{record_id}": post: summary: Submit a correction tags: - Corrections description: Submit a new correction for the given species, that will be reviewed and merged into the database. See [Complete our data](/docs/advanced/complete-data) to get started. operationId: createCorrection parameters: - name: record_id required: true in: path description: The id or the slug of the requested correction schema: type: string security: - token: [] responses: '200': description: Success content: application/json: schema: type: object properties: data: "$ref": "#/components/schemas/correction" meta: type: object properties: last_modified: type: string examples: returns-a-200-response: value: data: id: 13 record_type: Species record_id: 1164724 user_id: 42 warning_type: change_status: pending change_type: update accepted_by: notes: This tree can grows up to 68 meters created_at: '2020-08-11T16:23:10.454Z' updated_at: '2020-08-11T16:23:10.454Z' correction: maximum_height_value: 6800 maximum_height_unit: cm scientific_name: Abies alba changes: maximum_height_cm: - 5000 - 6800 meta: last_modified: '2020-08-11T16:23:10.454Z' '422': description: Invalid parameters content: application/json: examples: returns-a-422-response: value: error: true message: No correction has been submitted '401': description: Invalid credentials content: application/json: examples: returns-a-401-response: value: error: true messages: Invalid access token requestBody: content: application/json: schema: "$ref": "#/components/schemas/request_body_correction" components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT token: type: apiKey name: token in: query schemas: kingdom: type: object properties: id: type: integer name: type: string slug: type: string links: type: object properties: self: type: string required: - self required: - id - name - slug - links subkingdom: type: object properties: id: type: integer name: type: string slug: type: string kingdom: "$ref": "#/components/schemas/kingdom" links: type: object properties: self: type: string kingdom: type: string required: - self - kingdom required: - id - name - slug - links - kingdom division: type: object properties: id: type: integer name: type: string slug: type: string subkingdom: "$ref": "#/components/schemas/subkingdom" links: type: object properties: self: type: string subkingdom: type: string required: - self - subkingdom required: - id - name - slug - links - subkingdom division_class: type: object properties: id: type: integer name: type: string slug: type: string division: "$ref": "#/components/schemas/division" links: type: object properties: self: type: string division: type: string required: - self required: - id - name - slug - links division_order: type: object properties: id: type: integer name: type: string slug: type: string division_class: "$ref": "#/components/schemas/division_class" links: type: object properties: self: type: string division_class: type: string required: - self required: - id - name - slug - links family: type: object properties: id: type: integer name: type: string common_name: type: string nullable: true slug: type: string division_order: "$ref": "#/components/schemas/division_order" links: type: object properties: self: type: string division_order: type: string required: - self required: - id - name - slug - links genus: type: object properties: id: type: integer name: type: string slug: type: string family: "$ref": "#/components/schemas/family" links: type: object properties: self: type: string family: type: string required: - self required: - id - name - slug - links plant: type: object properties: id: type: integer common_name: type: string nullable: true slug: type: string scientific_name: type: string year: type: integer nullable: true bibliography: type: string nullable: true author: type: string nullable: true family_common_name: type: string nullable: true genus_id: type: integer main_species_id: type: integer nullable: true vegetable: type: boolean nullable: true observations: type: string nullable: true main_species: "$ref": "#/components/schemas/species" sources: type: array items: "$ref": "#/components/schemas/source" links: type: object properties: self: type: string genus: type: string species: type: string required: - self - genus - species required: - id - scientific_name - slug - links plant_light: type: object properties: id: type: integer common_name: type: string nullable: true slug: type: string scientific_name: type: string year: type: integer nullable: true bibliography: type: string nullable: true author: type: string nullable: true family_common_name: type: string nullable: true genus_id: type: integer main_species_id: type: integer nullable: true vegetable: type: boolean nullable: true observations: type: string nullable: true links: type: object properties: self: type: string genus: type: string species: type: string required: - self - genus - species required: - id - scientific_name - slug - links species: type: object properties: id: type: integer description: An unique identifier common_name: type: string nullable: true description: The usual common name, in english, of the species (if any). slug: type: string description: An unique human-readable identifier (if you can, prefer to use this over id) scientific_name: type: string description: The scientific name follows the [Binomial nomenclature](https://en.wikipedia.org/wiki/Binomial_nomenclature), and represents its genus and its species within the genus, resulting in a single worldwide name for each organism. The scientific name of an infraspecific taxons (ranks below species, such as subspecies, forms, varieties...) is a combination of the name of a species and an infraspecific epithet. A connecting term is used to denote the rank. [See IAPT recommendation](https://www.iapt-taxon.org/nomen/pages/main/art_24.html) year: type: integer nullable: true description: The first publication year of a valid name of this species. [See author citation](https://en.wikipedia.org/wiki/Author_citation_(botany)) bibliography: type: string nullable: true description: The first publication of a valid name of this species. [See author citation](https://en.wikipedia.org/wiki/Author_citation_(botany)) author: type: string nullable: true description: The author(s) of the first publication of a valid name of this species. [See author citation](https://en.wikipedia.org/wiki/Author_citation_(botany)) status: type: string enum: - accepted - unknown - description: The acceptance status of this species by IPNI rank: type: string enum: - species - ssp - var - form - hybrid - subvar - description: The [taxonomic rank](https://en.wikipedia.org/wiki/Taxonomic_rank) of the species family_common_name: type: string nullable: true description: The common name (in english) of the species family family: type: string description: The scientific name of the species family genus_id: type: integer description: The id of the species genus genus: type: string description: The scientific name of the species genus image_url: type: string nullable: true description: A main image url of the species links: type: object properties: self: type: string description: API endpoint to the species itself genus: type: string description: API endpoint to the species genus plant: type: string description: API endpoint to the species plant required: - self - genus - plant description: API endpoints to related resources duration: type: array nullable: true items: type: string nullable: true enum: - annual - biennial - perennial - description: | The plant duration(s), which can be: - Annual: plants that live, reproduce, and die in one growing season. - Biennial: plants that need two growing seasons to complete their life cycle, normally completing vegetative growth the first year and flowering the second year. - Perennial: plants that live for more than two years, with the shoot system dying back to soil level each year. description: | The plant duration(s), which can be: - Annual: plants that live, reproduce, and die in one growing season. - Biennial: plants that need two growing seasons to complete their life cycle, normally completing vegetative growth the first year and flowering the second year. - Perennial: plants that live for more than two years, with the shoot system dying back to soil level each year. observations: type: string nullable: true description: Some habit observations on the species images: type: object properties: flower: type: array items: type: object properties: id: type: integer description: An unique identifier image_url: type: string description: The url of the image copyright: type: string nullable: true description: A copyright (if any) for the image. Don't forget to properly credit the author if you're using them description: Image(s) of the species flower leaf: type: array items: type: object properties: id: type: integer description: An unique identifier image_url: type: string description: The url of the image copyright: type: string nullable: true description: A copyright (if any) for the image. Don't forget to properly credit the author if you're using them description: Image(s) of the species leaf habit: type: array items: type: object properties: id: type: integer description: An unique identifier image_url: type: string description: The url of the image copyright: type: string nullable: true description: A copyright (if any) for the image. Don't forget to properly credit the author if you're using them description: Image(s) of the species habit fruit: type: array items: type: object properties: id: type: integer description: An unique identifier image_url: type: string description: The url of the image copyright: type: string nullable: true description: A copyright (if any) for the image. Don't forget to properly credit the author if you're using them description: Image(s) of the species fruit bark: type: array items: type: object properties: id: type: integer description: An unique identifier image_url: type: string description: The url of the image copyright: type: string nullable: true description: A copyright (if any) for the image. Don't forget to properly credit the author if you're using them description: Image(s) of the species bark other: type: array items: type: object properties: id: type: integer description: An unique identifier image_url: type: string description: The url of the image copyright: type: string nullable: true description: A copyright (if any) for the image. Don't forget to properly credit the author if you're using them description: 'Image(s) of the species other ' common_names: type: object additionalProperties: type: array items: type: string nullable: true description: TODO description: Common names of the species per language distribution: type: object deprecated: true additionalProperties: type: array items: type: string nullable: true description: TODO description: "(Deprecated) Distribution of the species per establishment" distributions: type: object properties: native: type: array items: type: object properties: id: type: integer description: An unique identifier name: type: string description: The zone name slug: type: string description: An unique, human readable, identifier tdwg_code: type: string description: The TDWG zone unique code tdwg_level: type: integer description: The TDWG zone level species_count: type: integer description: The number of species in this zone links: type: object properties: self: type: string description: API endpoint to the zone itself species: type: string description: API endpoint to the species in this zone plants: type: string description: API endpoint to the plants in this zone description: Zones the species is native from introduced: type: array items: type: object properties: id: type: integer description: An unique identifier name: type: string description: The zone name slug: type: string description: An unique, human readable, identifier tdwg_code: type: string description: The TDWG zone unique code tdwg_level: type: integer description: The TDWG zone level species_count: type: integer description: The number of species in this zone links: type: object properties: self: type: string description: API endpoint to the zone itself species: type: string description: API endpoint to the species in this zone plants: type: string description: API endpoint to the plants in this zone description: Zones the species has been introduced doubtful: type: array items: type: object properties: id: type: integer description: An unique identifier name: type: string description: The zone name slug: type: string description: An unique, human readable, identifier tdwg_code: type: string description: The TDWG zone unique code tdwg_level: type: integer description: The TDWG zone level species_count: type: integer description: The number of species in this zone links: type: object properties: self: type: string description: API endpoint to the zone itself species: type: string description: API endpoint to the species in this zone plants: type: string description: API endpoint to the plants in this zone description: Zones the species presence is doubtful absent: type: array items: type: object properties: id: type: integer description: An unique identifier name: type: string description: The zone name slug: type: string description: An unique, human readable, identifier tdwg_code: type: string description: The TDWG zone unique code tdwg_level: type: integer description: The TDWG zone level species_count: type: integer description: The number of species in this zone links: type: object properties: self: type: string description: API endpoint to the zone itself species: type: string description: API endpoint to the species in this zone plants: type: string description: API endpoint to the plants in this zone description: Zones the species is absent and has been wrongly recorded extinct: type: array items: type: object properties: id: type: integer description: An unique identifier name: type: string description: The zone name slug: type: string description: An unique, human readable, identifier tdwg_code: type: string description: The TDWG zone unique code tdwg_level: type: integer description: The TDWG zone level species_count: type: integer description: The number of species in this zone links: type: object properties: self: type: string description: API endpoint to the zone itself species: type: string description: API endpoint to the species in this zone plants: type: string description: API endpoint to the plants in this zone description: Zones the species is extinct description: Distribution of the species per establishment flower: type: object properties: color: type: array nullable: true items: type: string nullable: true enum: - white - red - brown - orange - yellow - lime - green - cyan - blue - purple - magenta - grey - black - description: The flower color(s) description: The flower color(s) conspicuous: type: boolean nullable: true description: Is the flower visible ? description: Flower related fields (the reproductive structure found in flowering plants) foliage: type: object properties: texture: type: string nullable: true enum: - fine - medium - coarse - description: The general texture of the plant’s foliage color: type: array nullable: true items: type: string nullable: true enum: - white - red - brown - orange - yellow - lime - green - cyan - blue - purple - magenta - grey - black - description: The leaves color(s) description: The leaves color(s) leaf_retention: type: boolean nullable: true description: Does the leaves stay all year long ? description: Foliage (or leaves) related fields fruit_or_seed: type: object properties: conspicuous: type: boolean nullable: true description: Is the fruit visible ? color: type: array nullable: true items: type: string nullable: true enum: - white - red - brown - orange - yellow - lime - green - cyan - blue - purple - magenta - grey - black - description: The fruit color(s) description: The fruit color(s) shape: type: string nullable: true description: Fruit shape seed_persistence: type: boolean nullable: true description: Are the fruit or seed generally recognized as being persistent on the plant? description: Fruit or seed related fields specifications: type: object properties: ligneous_type: type: string nullable: true enum: - liana - subshrub - shrub - tree - parasite - description: The ligneous type of the woody plant growth_form: type: string nullable: true description: The primary growth form on the landscape in relation to soil stabilization on slopes and streamsides? Each plant species is assigned the single growth form that most enhances its ability to stabilize soil growth_habit: type: string nullable: true description: The general appearance, growth form, or architecture of the plant growth_rate: type: string nullable: true description: The relative growth speed of the plant average_height: type: object properties: cm: type: integer nullable: true description: The average height of the species, in centimeters description: The average height of the species, in centimeters maximum_height: type: object properties: cm: type: integer nullable: true description: The maximum height of the species, in centimeters description: The maximum height of the species, in centimeters nitrogen_fixation: type: string nullable: true description: Capability to fix nitrogen in monoculture shape_and_orientation: type: string nullable: true description: The predominant shape of the species toxicity: type: string nullable: true enum: - none - low - medium - high - description: Relative toxicity of the species for humans or animals description: Species's main characteristics growth: type: object properties: days_to_harvest: type: number nullable: true description: The average numbers of days required to from planting to harvest description: type: string nullable: true description: A description on how the plant usually grows sowing: type: string nullable: true description: A description on how to sow the plant ph_maximum: type: number nullable: true description: The maximum acceptable soil pH (of the top 30 centimeters of soil) for the plant ph_minimum: type: number nullable: true description: The minimum acceptable soil pH (of the top 30 centimeters of soil) for the plant light: type: integer nullable: true description: Required amount of light, on a scale from 0 (no light, <= 10 lux) to 10 (very intensive insolation, >= 100 000 lux) atmospheric_humidity: type: integer nullable: true description: Required relative humidity in the air, on a scale from 0 (<=10%) to 10 (>= 90%) growth_months: type: array nullable: true items: type: string nullable: true enum: - jan - feb - mar - apr - may - jun - jul - aug - sep - oct - nov - dec - description: The most active growth months of the species (usually all year round for perennial plants) description: The most active growth months of the species (usually all year round for perennial plants) bloom_months: type: array nullable: true items: type: string nullable: true enum: - jan - feb - mar - apr - may - jun - jul - aug - sep - oct - nov - dec - description: The months the species usually blooms description: The months the species usually blooms fruit_months: type: array nullable: true items: type: string nullable: true enum: - jan - feb - mar - apr - may - jun - jul - aug - sep - oct - nov - dec - description: The months the species usually produces fruits description: The months the species usually produces fruits row_spacing: type: object properties: cm: type: number nullable: true description: The minimum spacing between each rows of plants, in centimeters description: The minimum spacing between each rows of plants, in centimeters spread: type: object properties: cm: type: number nullable: true description: The average spreading of the plant, in centimeters description: The average spreading of the plant, in centimeters minimum_precipitation: type: object properties: mm: type: number nullable: true description: Minimum precipitation per year, in milimeters per year description: Minimum precipitation per year, in milimeters per year maximum_precipitation: type: object properties: mm: type: number nullable: true description: Maximum precipitation per year, in milimeters per year description: Maximum precipitation per year, in milimeters per year minimum_root_depth: type: object properties: cm: type: number nullable: true description: Minimum depth of soil required for the species, in centimeters. Plants that do not have roots such as rootless aquatic plants have 0 description: Minimum depth of soil required for the species, in centimeters. Plants that do not have roots such as rootless aquatic plants have 0 minimum_temperature: type: object properties: deg_f: type: number nullable: true description: The minimum tolerable temperature for the species. In fahrenheit degrees deg_c: type: number nullable: true description: The minimum tolerable temperature for the species. In celsius degrees description: The minimum tolerable temperature for the species. In celsius or fahrenheit degrees maximum_temperature: type: object properties: deg_f: type: number nullable: true description: The maximum tolerable temperature for the species. In fahrenheit degrees deg_c: type: number nullable: true description: The maximum tolerable temperature for the species. In celsius degrees description: The maximum tolerable temperature for the species. In celsius or fahrenheit degrees soil_nutriments: type: integer nullable: true description: Required quantity of nutriments in the soil, on a scale from 0 (oligotrophic) to 10 (hypereutrophic) soil_salinity: type: integer nullable: true description: Tolerance to salinity, on a scale from 0 (untolerant) to 10 (hyperhaline) soil_texture: type: integer nullable: true description: Required texture of the soil, on a scale from 0 (clay) to 10 (rock) soil_humidity: type: integer nullable: true description: Required humidity of the soil, on a scale from 0 (xerophile) to 10 (subaquatic) description: Growing of farming related fields synonyms: type: array items: type: object properties: id: type: integer description: An unique identifier name: type: string description: The scientific name of the symonym author: type: string nullable: true description: The author of the symonym description: The symonyms scientific names and authors sources: type: array items: type: object properties: id: type: string description: An unique identifier from the source name: type: string description: The name of the source citation: type: string nullable: true description: How to cite the source url: type: string nullable: true description: The link on the source website, or the publication reference last_update: type: string description: The last time the source was checked description: The symonyms scientific names and authors extras: description: '' required: - id - scientific_name - slug species_light: type: object properties: id: type: integer description: An unique identifier common_name: type: string nullable: true description: The usual common name, in english, of the species (if any). slug: type: string description: An unique human-readable identifier (if you can, prefer to use this over id) scientific_name: type: string description: The scientific name follows the [Binomial nomenclature](https://en.wikipedia.org/wiki/Binomial_nomenclature), and represents its genus and its species within the genus, resulting in a single worldwide name for each organism. The scientific name of an infraspecific taxons (ranks below species, such as subspecies, forms, varieties...) is a combination of the name of a species and an infraspecific epithet. A connecting term is used to denote the rank. [See IAPT recommendation](https://www.iapt-taxon.org/nomen/pages/main/art_24.html) year: type: integer nullable: true description: The first publication year of a valid name of this species. [See author citation](https://en.wikipedia.org/wiki/Author_citation_(botany)) bibliography: type: string nullable: true description: The first publication of a valid name of this species. [See author citation](https://en.wikipedia.org/wiki/Author_citation_(botany)) author: type: string nullable: true description: The author(s) of the first publication of a valid name of this species. [See author citation](https://en.wikipedia.org/wiki/Author_citation_(botany)) status: type: string enum: - accepted - unknown - description: The acceptance status of this species by IPNI rank: type: string enum: - species - ssp - var - form - hybrid - subvar - description: The [taxonomic rank](https://en.wikipedia.org/wiki/Taxonomic_rank) of the species family_common_name: type: string nullable: true description: The common name (in english) of the species family family: type: string description: The scientific name of the species family genus_id: type: integer description: The id of the species genus genus: type: string description: The scientific name of the species genus image_url: type: string nullable: true description: A main image url of the species links: type: object properties: self: type: string description: API endpoint to the species itself genus: type: string description: API endpoint to the species genus plant: type: string description: API endpoint to the species plant required: - self - genus - plant description: API endpoints to related resources synonyms: type: array items: type: string nullable: true description: TODO description: The symonyms scientific names required: - id - rank - family - genus - genus_id - scientific_name - slug - status - links description: The symonyms scientific names source: type: object properties: id: type: string nullable: true name: type: string url: type: string nullable: true last_update: type: string citation: type: string nullable: true required: - name - last_update correction: type: object properties: id: type: integer accepted_by: type: string nullable: true change_notes: type: string nullable: true change_status: type: string change_type: type: string correction: type: object nullable: true created_at: type: string notes: type: string nullable: true record_id: type: integer nullable: true record_type: type: string updated_at: type: string user_id: type: integer warning_type: type: string nullable: true required: - id - user_id - record_type - updated_at - created_at - change_type - change_status zone: type: object properties: id: type: integer name: type: string slug: type: string tdwg_code: type: string tdwg_level: type: integer species_count: type: integer links: type: object properties: self: type: string plants: type: string species: type: string required: - self - plants - species parent: type: object properties: id: type: integer name: type: string slug: type: string tdwg_code: type: string tdwg_level: type: integer species_count: type: integer links: type: object properties: self: type: string plants: type: string species: type: string required: - self - plants - species nullable: true children: type: array items: type: object properties: id: type: integer name: type: string slug: type: string tdwg_code: type: string tdwg_level: type: integer species_count: type: integer links: type: object properties: self: type: string plants: type: string species: type: string required: - self - plants - species required: - id - name - slug - links - tdwg_code - tdwg_level - species_count request_body_correction: type: object properties: notes: type: string nullable: true description: Some optional notes you can add. They will be visible to everybody source_type: type: string enum: - external - observation - report - nullable: true description: Where does this data come from ? If "external", you'll need to provide the "source_reference" field with the url or the name of the source, such as a wikipedia article, a publication, etc... source_reference: type: string nullable: true description: The url of the name of an article or a publication for theses changes correction: type: object properties: scientific_name: type: string example: Abelmoschus nonexistus rank: type: string enum: - species - ssp - var - form - hybrid - subvar - example: species genus: type: string nullable: true example: Rosa year: type: integer nullable: true example: author: type: string nullable: true example: Moench bibliography: type: string nullable: true example: common_name: type: string nullable: true description: The species common name(s) in english. Several values can be separated with "|" example: Okra|Bonnie Green Okra observations: type: string nullable: true example: Vegetal flavour, Medium-yellow flowers planting_description: type: string nullable: true description: A description on how the plant usually grows planting_sowing_description: type: string nullable: true example: A description on how to sow the plant duration: anyOf: - type: array items: type: string enum: - annual - biennial - perennial - nullable: true description: The duration(s) of the species. Several values can be separated with "|" example: annual - type: string enum: - annual - biennial - perennial - nullable: true description: The duration(s) of the species. Several values can be separated with "|" example: annual flower_color: anyOf: - type: array items: type: string enum: - white - red - brown - orange - yellow - lime - green - cyan - blue - purple - magenta - grey - black - nullable: true description: The species flower color(s). Several values can be separated with "|" example: yellow - type: string enum: - white - red - brown - orange - yellow - lime - green - cyan - blue - purple - magenta - grey - black - nullable: true description: The species flower color(s). Several values can be separated with "|" example: yellow flower_conspicuous: type: boolean nullable: true example: true foliage_color: anyOf: - type: array items: type: string enum: - white - red - brown - orange - yellow - lime - green - cyan - blue - purple - magenta - grey - black - nullable: true description: The species foliage color(s). Several values can be separated with "|" example: green|blue - type: string enum: - white - red - brown - orange - yellow - lime - green - cyan - blue - purple - magenta - grey - black - nullable: true description: The species foliage color(s). Several values can be separated with "|" example: green|blue foliage_texture: type: string enum: - fine - medium - coarse - nullable: true example: leaf_retention: type: boolean nullable: true example: false fruit_color: anyOf: - type: array items: type: string enum: - white - red - brown - orange - yellow - lime - green - cyan - blue - purple - magenta - grey - black - nullable: true description: The species fruit color(s). Several values can be separated with "|" example: white - type: string enum: - white - red - brown - orange - yellow - lime - green - cyan - blue - purple - magenta - grey - black - nullable: true description: The species fruit color(s). Several values can be separated with "|" example: white fruit_conspicuous: type: boolean nullable: true example: false fruit_seed_persistence: type: boolean nullable: true example: false fruit_months: anyOf: - type: array items: type: string enum: - jan - feb - mar - apr - may - jun - jul - aug - sep - oct - nov - dec - nullable: true description: The months when his species have fruits. Several values can be separated by "|" example: jan|feb|mar - type: string enum: - jan - feb - mar - apr - may - jun - jul - aug - sep - oct - nov - dec - nullable: true description: The months when his species have fruits. Several values can be separated by "|" example: jan|feb|mar bloom_months: anyOf: - type: array items: type: string enum: - jan - feb - mar - apr - may - jun - jul - aug - sep - oct - nov - dec - nullable: true description: The months when this species blooms. Several values can be separated by "|" example: - type: string enum: - jan - feb - mar - apr - may - jun - jul - aug - sep - oct - nov - dec - nullable: true description: The months when this species blooms. Several values can be separated by "|" example: ground_humidity: type: integer nullable: true description: Required humidity of the soil, on a scale from 0 (xerophile) to 10 (subaquatic) example: growth_form: type: string nullable: true example: growth_habit: type: string nullable: true example: growth_months: anyOf: - type: array items: type: string enum: - jan - feb - mar - apr - may - jun - jul - aug - sep - oct - nov - dec - nullable: true description: The months when this species grows. Several values can be separated by "|" example: - type: string enum: - jan - feb - mar - apr - may - jun - jul - aug - sep - oct - nov - dec - nullable: true description: The months when this species grows. Several values can be separated by "|" example: growth_rate: type: string nullable: true example: edible_part: anyOf: - type: array items: type: string enum: - roots - stem - leaves - flowers - fruits - seeds - nullable: true description: The edible part of the species (if any). Several values can be separated by "|" example: flowers - type: string enum: - roots - stem - leaves - flowers - fruits - seeds - nullable: true description: The edible part of the species (if any). Several values can be separated by "|" example: flowers vegetable: type: boolean nullable: true example: false light: type: integer nullable: true description: Required amount of light, on a scale from 0 (no light, <= 10 lux) to 10 (very intensive insolation, >= 100 000 lux) example: 8 atmospheric_humidity: type: integer nullable: true description: Required relative humidity in the air, on a scale from 0 (<=10%) to 10 (>= 90%) example: 3 adapted_to_coarse_textured_soils: type: string nullable: true example: adapted_to_fine_textured_soils: type: string nullable: true example: adapted_to_medium_textured_soils: type: string nullable: true example: anaerobic_tolerance: type: string nullable: true example: average_height_unit: type: string enum: - in - ft - cm - m nullable: true example: cm average_height_value: type: number nullable: true example: '250' maximum_height_unit: type: string enum: - in - ft - cm - m nullable: true example: cm maximum_height_value: type: number nullable: true example: '280' planting_row_spacing_unit: type: string enum: - in - ft - cm - m nullable: true example: cm planting_row_spacing_value: type: number nullable: true example: '80' description: The minimum spacing between each rows of plants planting_spread_unit: type: string enum: - in - ft - cm - m nullable: true example: cm planting_spread_value: type: number nullable: true example: '100' description: The average spreading of the plant planting_days_to_harvest: type: integer nullable: true example: 120 maximum_precipitation_unit: type: string enum: - in - ft - mm - cm - m nullable: true example: mm maximum_precipitation_value: type: number nullable: true example: '2230' minimum_precipitation_unit: type: string enum: - in - ft - mm - cm - m nullable: true example: mm minimum_precipitation_value: type: number nullable: true example: '1300' minimum_root_depth_unit: type: string enum: - in - ft - cm - m nullable: true example: cm minimum_root_depth_value: type: number nullable: true example: '30' ph_maximum: type: number nullable: true example: ph_minimum: type: number nullable: true example: soil_nutriments: type: integer nullable: true description: Required quantity of nutriments in the soil, on a scale from 0 (oligotrophic) to 10 (hypereutrophic) soil_salinity: type: integer nullable: true description: Tolerance to salinity, on a scale from 0 (untolerant) to 10 (hyperhaline) minimum_temperature_deg_c: type: number nullable: true example: 5 description: The minimum required temperature in celcius degrees maximum_temperature_deg_c: type: number nullable: true example: 20 description: The maximum required temperature in celcius degrees soil_texture: type: integer description: Required texture of the soil, on a scale from 0 (clay) to 10 (rock) nullable: true example: ligneous_type: type: string enum: - liana - subshrub - shrub - tree - parasite - nullable: true example: toxicity: type: string enum: - none - low - medium - high - nullable: true example: required: - scientific_name description: The fields to correct filters_families: type: object properties: name: type: string slug: type: string filters_genus: type: object properties: name: type: string slug: type: string family_id: type: string filters_plants: type: object properties: author: type: string bloom_months: type: string common_name: type: string duration: type: string family_common_name: type: string flower_conspicuous: type: string foliage_texture: type: string fruit_conspicuous: type: string fruit_seed_persistence: type: string growth_form: type: string growth_habit: type: string growth_rate: type: string leaf_retention: type: string lifespan: type: string ligneous_type: type: string rank: type: string scientific_name: type: string status: type: string vegetable: type: string growth_months: type: string fruit_months: type: string flower_color: type: string foliage_color: type: string fruit_color: type: string edible_part: type: string establishment: type: string genus_name: type: string filters_species: type: object properties: author: type: string bloom_months: type: string common_name: type: string duration: type: string family_common_name: type: string flower_conspicuous: type: string foliage_texture: type: string fruit_conspicuous: type: string fruit_seed_persistence: type: string growth_form: type: string growth_habit: type: string growth_rate: type: string leaf_retention: type: string lifespan: type: string ligneous_type: type: string rank: type: string scientific_name: type: string status: type: string vegetable: type: string growth_months: type: string fruit_months: type: string flower_color: type: string foliage_color: type: string fruit_color: type: string edible_part: type: string establishment: type: string genus_name: type: string filters_not_species: type: object properties: image_url: type: string author: type: string average_height_cm: type: string bibliography: type: string common_name: type: string edible_part: type: string family_common_name: type: string flower_color: type: string flower_conspicuous: type: string foliage_color: type: string foliage_texture: type: string frost_free_days_minimum: type: string fruit_color: type: string fruit_conspicuous: type: string fruit_seed_persistence: type: string ground_humidity: type: string growth_form: type: string growth_habit: type: string growth_rate: type: string genus_name: type: string images_count: type: string leaf_retention: type: string lifespan: type: string light: type: string ligneous_type: type: string maximum_height_cm: type: string maximum_precipitation_mm: type: string maximum_temperature_deg_c: type: string maximum_temperature_deg_f: type: string minimum_precipitation_mm: type: string minimum_root_depth_cm: type: string minimum_temperature_deg_c: type: string minimum_temperature_deg_f: type: string ph_maximum: type: string ph_minimum: type: string planting_days_to_harvest: type: string planting_row_spacing_cm: type: string planting_spread_cm: type: string rank: type: string scientific_name: type: string soil_nutriments: type: string soil_salinity: type: string soil_texture: type: string status: type: string synonyms_count: type: string sources_count: type: string toxicity: type: string vegetable: type: string year: type: string sorts_families: type: object properties: name: type: string slug: type: string sorts_genus: type: object properties: name: type: string slug: type: string family_id: type: string sorts_plants: type: object properties: atmospheric_humidity: type: string author: type: string average_height_cm: type: string bibliography: type: string common_name: type: string duration: type: string edible: type: string family_common_name: type: string flower_color: type: string flower_conspicuous: type: string foliage_color: type: string foliage_texture: type: string frost_free_days_minimum: type: string fruit_color: type: string fruit_conspicuous: type: string fruit_seed_persistence: type: string ground_humidity: type: string growth_form: type: string growth_habit: type: string growth_rate: type: string images_count: type: string leaf_retention: type: string lifespan: type: string light: type: string ligneous_type: type: string maximum_height_cm: type: string maximum_precipitation_mm: type: string maximum_temperature_deg_c: type: string maximum_temperature_deg_f: type: string minimum_precipitation_mm: type: string minimum_root_depth_cm: type: string minimum_temperature_deg_c: type: string minimum_temperature_deg_f: type: string ph_maximum: type: string ph_minimum: type: string planting_days_to_harvest: type: string planting_row_spacing_cm: type: string planting_spread_cm: type: string rank: type: string scientific_name: type: string soil_nutriments: type: string soil_salinity: type: string soil_texture: type: string sources_count: type: string status: type: string synonyms_count: type: string toxicity: type: string vegetable: type: string year: type: string updated_at: type: string sorts_species: type: object properties: atmospheric_humidity: type: string author: type: string average_height_cm: type: string bibliography: type: string common_name: type: string duration: type: string edible: type: string family_common_name: type: string flower_color: type: string flower_conspicuous: type: string foliage_color: type: string foliage_texture: type: string frost_free_days_minimum: type: string fruit_color: type: string fruit_conspicuous: type: string fruit_seed_persistence: type: string ground_humidity: type: string growth_form: type: string growth_habit: type: string growth_rate: type: string images_count: type: string leaf_retention: type: string lifespan: type: string light: type: string ligneous_type: type: string maximum_height_cm: type: string maximum_precipitation_mm: type: string maximum_temperature_deg_c: type: string maximum_temperature_deg_f: type: string minimum_precipitation_mm: type: string minimum_root_depth_cm: type: string minimum_temperature_deg_c: type: string minimum_temperature_deg_f: type: string ph_maximum: type: string ph_minimum: type: string planting_days_to_harvest: type: string planting_row_spacing_cm: type: string planting_spread_cm: type: string rank: type: string scientific_name: type: string soil_nutriments: type: string soil_salinity: type: string soil_texture: type: string sources_count: type: string status: type: string synonyms_count: type: string toxicity: type: string vegetable: type: string year: type: string updated_at: type: string ranges_plants: type: object properties: atmospheric_humidity: type: string frost_free_days_minimum: type: string ground_humidity: type: string images_count: type: string light: type: string average_height_cm: type: string maximum_height_cm: type: string maximum_precipitation_mm: type: string maximum_temperature_deg_c: type: string maximum_temperature_deg_f: type: string minimum_precipitation_mm: type: string minimum_root_depth_cm: type: string minimum_temperature_deg_c: type: string minimum_temperature_deg_f: type: string ph_maximum: type: string ph_minimum: type: string planting_days_to_harvest: type: string planting_row_spacing_cm: type: string planting_spread_cm: type: string soil_nutriments: type: string soil_salinity: type: string soil_texture: type: string synonyms_count: type: string sources_count: type: string toxicity: type: string year: type: string ranges_species: type: object properties: atmospheric_humidity: type: string frost_free_days_minimum: type: string ground_humidity: type: string images_count: type: string light: type: string average_height_cm: type: string maximum_height_cm: type: string maximum_precipitation_mm: type: string maximum_temperature_deg_c: type: string maximum_temperature_deg_f: type: string minimum_precipitation_mm: type: string minimum_root_depth_cm: type: string minimum_temperature_deg_c: type: string minimum_temperature_deg_f: type: string ph_maximum: type: string ph_minimum: type: string planting_days_to_harvest: type: string planting_row_spacing_cm: type: string planting_spread_cm: type: string soil_nutriments: type: string soil_salinity: type: string soil_texture: type: string synonyms_count: type: string sources_count: type: string toxicity: type: string year: type: string servers: - url: http://{defaultHost} variables: defaultHost: default: trefle.io