---
title: "List all results"
method: GET
path: "/results"
tags: ["Results"]
---

# List all results

`GET /results`

## Request

- Base URL: `https://api.physikit.com/v2`
- URL: `https://api.physikit.com/v2/results`
- Auth: HTTP bearer

Retrieve biomarker results.

**Usage modes**
1. **Filtered** – add one or more `order_id` **or** `kit_id` query parameters (max 100 each). Only orders that already have results are returned.
2. **Browse** – omit both filters to page through all finished results.

In both cases the response contains:
* `data` – the list of result objects (may be empty), and
* `meta` – pagination info (`total`, `limit`, `offset`).
`limit`/`offset` are respected even when filters are supplied.

## Query parameters

- `order_id` string[], nullable: Repeat for each order ID, e.g. `?order_id=...&order_id=...`
- `kit_id` string[], nullable: Repeat for each kit ID, e.g. `?kit_id=KIT0001&kit_id=KIT0002`. **Note:** Filtering by `kit_id` is **case-sensitive**. Most laboratory systems store and report kit identifiers in **uppercase** (e.g. `KIT0001`), and the API matches them exactly. Ensure you use the correct letter case when querying.
- `limit` integer: Items per page when filters are omitted
- `offset` integer: Zero-based page offset

## Response `200`

Successful Response

- ResultListResponse
  - `data` OrderResults[], required
    - `order_id` string, required
    - `kit_id` string, required
    - `panels` PanelResults[], required
      - `panel_id` string, required
      - `panel_name` string, required
      - `panel_biomarkers` BiomarkerResult[], required
        - `biomarker_id` string, required
        - `biomarker_name` string, required
        - `biomarker_unit` string, required
        - `measured_value` number, nullable: Measured value; null when not available
  - `meta` Meta, required
    - `total` integer, required
    - `limit` integer, required
    - `offset` integer, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Content
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/physikit/apis/physikit-api.md) - [All operations](https://skmtc.dev/physikit/apis/physikit-api/llms.txt) - [OpenAPI document](https://skmtc.dev/physikit/apis/physikit-api/revisions/c997ee521963?raw)