How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Element Biosciences Run Service API

RunService provides access to instrument runs, both sequencing and multiomics. Listing and reading run metadata requires the "runs:read" scope; listing run files and obtaining download credentials requires the "runs:download" scope.

Element Biosciences Run Service API is one of 5 APIs that Element Biosciences publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include RunService. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 4 operations across 4 paths, and defines 28 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://cloud-api.usw2.elembio.io.

4 operations 4 paths 28 schemas 4 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://cloud-api.usw2.elembio.io
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Element Biosciences Run Service API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (apiKey). By default, every request must be authenticated.

  • apiKey — API key obtained from the Element Biosciences Cloud console

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 4 GET. Each is listed below with its method, path, parameters, and response codes.

RunService 4

RunService provides access to instrument runs, both sequencing and multiomics. Listing and reading run metadata requires the "runs:read" scope; listing run files and obtaining dow…

GET
/v1/runs
ListRuns
RunService_ListRuns 4 params → 200400401403404500
GET
/v1/runs/{id}
GetRun
RunService_GetRun 1 param → 200400401403404500
GET
/v1/runs/{run_id}/credentials
GetRunDownloadCredentials
RunService_GetRunDownloadCredentials 3 params → 200400401403404500
GET
/v1/runs/{run_id}/files
ListRunFiles
RunService_ListRunFiles 8 params → 200400401403404500

Schemas 28

The contract defines 28 schemas that model the data the API accepts and returns. The most detailed are elembio.cloud.v1.Run (18 properties), elembio.cloud.v1.SequencingSetup (15 properties), elembio.cloud.v1.MultiomicsSetup (12 properties), elembio.cloud.v1.SequencingMetrics (9 properties). Each schema is shown below with its type and property counts.

elembio.cloud.v1.ListRunsResponse
object
Response containing a list of runs
4 properties
elembio.cloud.v1.Well
object
Well information for multiomics runs
2 properties
elembio.cloud.v1.RunMetrics
object
Run metrics/results, grouped by run type. Only one of the type-specific sub-messages will be populated per run.
2 properties
elembio.cloud.v1.RunSetup
object
Run setup configuration, grouped by run type. Only one of the type-specific sub-messages will be populated per run.
2 properties
elembio.cloud.v1.RunRecipe
object
Element recipe selected for a run.
2 properties
elembio.cloud.v1.MultiomicsSetup
object
Multiomics run setup/configuration fields
12 properties
elembio.cloud.v1.Run
object
A Run represents an instrument run (either sequencing or multiomics)
18 properties
elembio.cloud.v1.ListRunFilesResponse
object
Response containing files for a run
4 properties
elembio.cloud.v1.S3Credentials
object
Temporary read-only AWS S3 credentials scoped to a bucket and prefix. Use with the AWS CLI, AWS SDK, or any S3-compatible tool. The credentials expire at the t…
7 properties
elembio.cloud.v1.Consumable
object
Consumable information (used for both run types)
4 properties
Error
object
Error response returned by all endpoints when a request fails.
3 properties 2 required
elembio.cloud.v1.SequencingMetrics
object
Sequencing run metrics
9 properties
elembio.cloud.v1.ReadConfig
object
Read configuration for sequencing
3 properties
elembio.cloud.v1.RunStatus
string
Status of a run, matching the status shown in the EBC UI.
elembio.cloud.v1.File
object
A File represents an object in cloud storage.
7 properties
elembio.cloud.v1.Cartridge
object
Cartridge information for multiomics runs
3 properties
elembio.cloud.v1.SequencingSetup
object
Sequencing run setup/configuration fields
15 properties
elembio.cloud.v1.RunManifest
object
Manifest metadata for a run (only fully populated on GetRun)
4 properties
ErrorDetail
object
Structured error detail with a machine-readable reason code.
4 properties 2 required
elembio.cloud.v1.RunDesign
object
Design associated with a run
3 properties
google.protobuf.Timestamp
string
A Timestamp represents a point in time independent of any time zone or local calendar, encoded as a count of seconds and fractions of seconds at nanosecond res…
elembio.cloud.v1.RunInstrument
object
Instrument that performed a run. These fields are a snapshot captured at run time and may differ from the instrument's current state as returned by InstrumentS…
5 properties
elembio.cloud.v1.MultiomicsMetrics
object
Multiomics run metrics
3 properties
elembio.cloud.v1.Panel
object
Panel information for multiomics runs
3 properties
elembio.cloud.v1.Output
object
Output describes where a resource's output files live and what kinds of content are produced. Used by both Run and Execution.
3 properties
elembio.cloud.v1.Batch
object
Batch information for multiomics runs
3 properties
elembio.cloud.v1.GetRunDownloadCredentialsResponse
object
Response containing temporary download credentials for a run
elembio.cloud.v1.GetRunResponse
object
Response containing a single run with full details
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

element-biosciences-runservice-api-openapi.yml Raw ↑

Other APIs Element Biosciences publishes across the network.

Element Biosciences Auth Service API
Element Biosciences Execution Service API
Element Biosciences Instrument Service API
Element Biosciences Storage Connection Service API
Where this information came from

This is an independent, third-party profile of Element Biosciences Run Service API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.