NCnceas
Taxon observations

Get all taxon observations

Changed on

Retrieve a paginated collection of all taxon observations recorded in VegBank.

get/taxon-observations

Request

Query parameters

detail'minimal' | 'full'

Level of detail for the response:

  • minimal: Returns basic fields only
  • full: Returns more fields
with_nestedboolean

Whether to include nested fields in the response

limitinteger

Maximum number of records to return

offsetinteger

Number of records to skip before starting to return records

create_parquetboolean

If true, return data payload in binary Parquet format

Response

Matching taxon observation(s), with fields based on parameters:

  • detail=minimal&with_nested=false: Basic fields only
  • detail=minimal&with_nested=true: Basic fields + nested array fields
  • detail=full&with_nested=false: Extended fields, no nested array fields
  • detail=full&with_nested=true: Extended fields + nested array fields
OR
OR
OR

Example response

{
  "count": 115000,
  "data": [
    {
      "to_code": "to.1",
      "ob_code": "ob.1",
      "int_curr_pc_code": "pc.1",
      "int_orig_pc_code": "pc.1",
      "taxon_inference_area": 405,
      "rf_code": "rf.1"
    }
  ]
}

Changes

  • c37c8d7a84c5Revision changes
    • breaking

      added to the response body oneOf list for the response status

    • warning

      removed the optional property /////////// from the response with the status

    • warning

      removed the optional property /////////// from the response with the status

    • warning

      removed the optional property /////////// from the response with the status

    • warning

      removed the optional property /////////// from the response with the status

    • warning

      removed the optional property /////////// from the response with the status

    • warning

      removed the optional property /////////// from the response with the status

    • warning

      removed the optional property /////////// from the response with the status

    • warning

      removed the optional property /////////// from the response with the status

    • warning

      removed the optional property /////////// from the response with the status

    • warning

      removed the optional property /////////// from the response with the status

    • warning

      removed the optional property /////////// from the response with the status

    • warning

      removed the optional property /////////// from the response with the status

    • info

      added the new optional query request parameter detail

    • info

      added the optional property /////////// to the response with the status

    • info

      added the optional property /////////// to the response with the status

    • info

      added to the ////// response property allOf list for the response status

    • info

      added to the ////// response property allOf list for the response status

    • info

      removed from the ////// response property allOf list for the response status

  • 2e123831df6eRevision changes
    • breaking

      for the query request parameter limit, default value 1000 was added

    • breaking

      for the query request parameter offset, default value 0 was added

    • breaking

      added to the response body oneOf list for the response status

    • warning

      for the query request parameter limit, the min was set to 0.00

    • warning

      for the query request parameter offset, the min was set to 0.00

    • warning

      deleted the query request parameter detail

    • warning

      deleted the query request parameter numTaxa

    • info

      api operation id get-to was added

    • info

      api tag Taxon observations added

    • info

      added the new optional query request parameter create_parquet

    • info

      added the new optional query request parameter with_nested

    • info

      added the media type application/vnd.apache.parquet for the response with the status

    • info

      added the non-success response with the status