Retrieve paginated query result [DEPRECATED]
GET/query/:queryId/result
This endpoint has been deprecated and should not be used in production environments. It will be permanently unavailable after 3rd October 2024.
Instead, users should use the GET /query/:queryId/result/download
endpoint, which supports single request, large-volume downloads.
For further assistance, please contact your Gardin account manager or email us at tech@gardin.ag.
Retrieve the results of a finished query.
Results are paginated into pages of 100 records, unless fewer than 100 remain, in which case the final page will include all remaining records. Use nextToken
to request the next page. You can refer to totalRecordCount
from Get status of a submitted query (/query/:queryId/status
) to determine the total number of pages to expect.
Results for a query (identified by :queryId
) can only be accessed by the user who originally submitted it.
Required scope(s): [data.chf:query
, data.indices:query
]
Request
Path Parameters
Unique identifier of the query.
Query Parameters
Base64-encoded pagination token. Provide to request the next page of records.
Responses
- 200
- 401
- 403
- 404
- 500
Successful retrieval of query results (paginated).
- application/json
- Schema
- Example (from schema)
- Example 1 - ChF measurements (single record)
- Example 2 - Indices (multiple paginated records)
Schema
- QueryResultChfResponse
- QueryResultIndicesResponse
The total number of records returned in the current page.
Base64-encoded pagination token. If present in the response, then further pages of results are available, and can be passed into the request body to retrieve the next page.
data object
List of result records in current page.
The unique identifier for the measurement.
The timestamp (UTC) of the record.
The ID of the sensor that performed the measurement.
The ID of the growth job associated with the measurement.
F0 (Minimum Fluorescence) - The fluorescence yield when all PSII reaction centers are open, measured under very low light conditions to avoid photochemical activity.
FM (Maximum Fluorescence) - The maximum fluorescence yield when all PSII reaction centers are closed, typically measured under a saturating pulse of light.
FV (Variable Fluorescence) - The difference between FM and F0, representing the variable portion of fluorescence that is directly related to the maximum quantum efficiency of PSII photochemistry.
QE (Quantum Efficiency of PSII) - Sometimes referred to as ΦPSII, represents the efficiency of energy conversion in PSII under light-adapted conditions.
FV/FM (Maximum Quantum Yield of PSII) - The ratio of variable to maximum fluorescence, indicating the maximum potential quantum efficiency of PSII in a dark-adapted state.
F0' (F0 Prime) - The minimal fluorescence yield in light-adapted states, when all PSII reaction centers are open but adapted to ambient light conditions.
FV'/FM' (FV Prime over FM Prime) - The efficiency of energy conversion in PSII under light-adapted conditions, reflecting the quantum yield of PSII photochemistry in light.
QP (Photochemical Quenching) - A parameter reflecting the proportion of open PSII reaction centers that can perform photochemistry.
F0'/F0 (F0 Prime over F0) - The ratio of minimal fluorescence in light-adapted conditions to that in dark-adapted conditions, indicating changes in energy transfer efficiency.
FQ'/FM' (FQ Prime over FM Prime) - Reflects the quantum yield of photochemical energy conversion in PSII under light-adapted conditions. It is analogous to FV'/FM' but emphasizes the difference between light-adapted FM' and the actual fluorescence yield under ambient light.
NPQ (Non-Photochemical Quenching) - A mechanism that dissipates excess light energy as heat to protect the plant from photodamage, measured as the decrease in fluorescence yield under high light conditions.
QL (Lake Model Quenching) - Represents the distribution of excitation energy between open and closed PSII reaction centers, based on the lake model of photosystem II.
QCN - A specific parameter related to non-photochemical quenching processes.
FV/F0 (FV over F0) - The ratio of variable fluorescence to minimum fluorescence, providing an indication of the potential efficiency of PSII in converting light energy to chemical energy in a dark-adapted state.
The timestamp (UTC) of the record.
The ID of the sensor that performed the measurements from which the index value has been calculated.
The ID of the growth job associated with the index value.
Possible values: [PHI
, PS2
, PUI
, PEI
, ETR
, PAR
, QE
]
The name of the Gardin index. Please refer to indexName
request parameter in the POST /query
endpoint documentation for details.
The value of the named index for the specified timestamp, growth job and device.
{
"recordCount": 100,
"nextToken": "eyJSRUNPUkRfTk8iOiB7Ik4iOiAiOTkifSwgIlFVRVJZX0lEIjogeyJTIjogImNhYjQzYWEwLWEyYjMtNDBmNS05OGQ2LWE1ZDMxZmZkY2IwMSJ9fQ==",
"data": {}
}
{
"recordCount": 1,
"data": {
"0": {
"measurementId": "f10b508e-a2ff-4190-857c-c6b6658077c6",
"timestamp": "2024-02-21T17:32:28Z",
"jobId": "STRAWBERRY-Z1.20240201",
"deviceId": "G111001",
"f0": 15.91,
"fm": 44.06,
"fv": 28.17,
"qe": 0.63,
"f0x": null,
"npq": null,
"fvx_fmx": null,
"ql": null,
"qp": null,
"f0x_f0": null,
"qcn": null,
"fv_fm": 0.63,
"fv_f0": 1.77,
"fqx_fmx": null
}
}
}
{
"recordCount": 100,
"data": {
"0": {
"jobId": "STRAWBERRY-Z1.20240201-1",
"timestamp": "2024-02-21T18:00:00Z",
"indexName": "PHI",
"deviceId": "G111001",
"indexValue": 81
},
"1": {
"jobId": "STRAWBERRY-Z1.20240201-1",
"timestamp": "2024-02-21T19:00:00Z",
"indexName": "PHI",
"deviceId": "G111001",
"indexValue": 82
},
"2": {
"description": "Records 2 to 98 omitted for brevity."
},
"99": {
"jobId": "STRAWBERRY-Z1.20240201-25",
"timestamp": "2024-02-21T18:00:00Z",
"indexName": "PUI",
"deviceId": "G111005",
"indexValue": 46
}
},
"nextToken": "eyJSRUNPUkRfTk8iOiB7Ik4iOiAiOTkifSwgIlFVRVJZX0lEIjogeyJTIjogImNhYjQzYWEwLWEyYjMtNDBmNS05OGQ2LWE1ZDMxZmZkY2IwMSJ9fQ=="
}
Unauthorized - invalid access token or requesting user is not the original query submitter.
- application/json
- Schema
- Example (from schema)
Schema
Details of the error.
{
"message": "string"
}
Forbidden - invalid access token or user not authorised.
- application/json
- Schema
- Example (from schema)
Schema
Details of the error.
{
"message": "string"
}
Query not found
- application/json
- Schema
- Example (from schema)
Schema
Details of the error.
{
"message": "string"
}
Internal server error - contact tech@gardin.ag for further assistance.
- application/json
- Schema
- Example (from schema)
Schema
Details of the error.
{
"message": "string"
}