results-v1 | Matrix Sciences FSQ API

List test results

Retrieve a page of laboratory test results with sample context, test codes, reported values, units, and specification text. A sample can have multiple result records; preserve the test context alongside the sample identifier.

Request: GET {{baseUrl}}/{{results}}
Success: 200 OK with a JSON body. The recorded response media type is text/plain;charset=utf-8. No request body is used.

Query parameters

Parameter	Format	Usage
`api_token`	String	Credential for the selected environment, supplied through `{{api_token}}`.
`page`	Integer in the query string	Page to retrieve. The saved request starts at `1`.
`sample_id`	String	Sample identifier filter. The saved request sends an empty value.
`sample_submission_id`	String	Sample-submission row identifier filter. The saved request sends an empty value.
`start_date`	`YYYY-MM-DD`	Start of the requested date range. Replace the saved example date with your intended range.
`end_date`	`YYYY-MM-DD`	End of the requested date range. Replace the saved example date with your intended range.

Filter requiredness, empty-versus-omitted behavior, matching rules, and filter combinations are unconfirmed. The filtered date field, timezone, and inclusive/exclusive boundaries are also unspecified. Do not assume this range selects collection, submission, or validation dates without confirmation.

Response envelope

Field	Observed type	Description
`page`	String	Returned page number, for example `"1"`.
`hasNextPage`	Boolean	Indicates whether another page is available.
`results`	Array of objects	Test result records in this page.

Keep filters unchanged while paging. Increment page when hasNextPage is true and stop when it is false.

Result fields

Types below reflect the saved response.

Field	Observed type	Description
`sample_id`	String	Downstream sample identifier. Multiple tests can reference the same sample.
`test_name`	String	Human-readable test name.
`analyte_group`	String	Analyte grouping associated with the test.
`test_code`	String	Test catalog code, such as `LSP-VID-ENV`.
`result`	String	Reported value. Examples include numeric text such as `"78"` and qualitative text such as `"Presumptive"`.
`unit`	String	Reported unit or basis of measurement, such as `CFU/exposure` or `per area swabbed`.
`specification`	String	Specification text reported by the service, such as `in spec`; the complete vocabulary is unspecified.
`submitted_at`	String	Submission date and time as display text.
`collected_at`	String	Collection date and time as display text.
`description`	String	Sample description; may be empty.
`product_id`	String	Product identifier returned by the service.
`product_description`	String	Product description; may be empty.
`lot`	String	Lot reference. Preserve as text.
`request_number`	String	Request reference; may be empty.
`status`	String	Status returned with the result. `completed` appears in the saved response; the full set is unspecified.
`due_date`	String	Due date and time as display text.

Working with results

Preserve result as a string. Converting every result to a number loses qualitative values.
Store the reported unit and specification with each value; neither is inferred from the result text.
Date strings have no timezone offset and are in Central Time (UTC-5).

Saved example

The attached 200 example uses synthetic records to illustrate numeric and qualitative results and hasNextPage: false.

Query parameters

api_tokenstringOptional

pageintegerOptional

sample_idstringOptional

sample_submission_idstringOptional

start_datestringOptional

end_datestringOptional