Skip to content
Go to Boltz API

Get generated small molecule designs

client.SmallMolecule.Design.ListResults(ctx, id, query) (*CursorPage[SmallMoleculeDesignListResultsResponse], error)
GET/compute/v1/small-molecule/design/{id}/results

Retrieve paginated results from a design run

ParametersExpand Collapse
id string
query SmallMoleculeDesignListResultsParams
AfterID param.Field[string]optional

Return results after this ID

BeforeID param.Field[string]optional

Return results before this ID

Limit param.Field[int64]optional

Max results to return. Defaults to 100.

minimum1
maximum1000
WorkspaceID param.Field[string]optional

Workspace ID. Only used with admin API keys. Ignored (or validated) for workspace-scoped keys.

ReturnsExpand Collapse
type SmallMoleculeDesignListResultsResponse struct{…}

A single designed small molecule result

ID string

Unique result ID

Artifacts SmallMoleculeDesignListResultsResponseArtifacts
Archive SmallMoleculeDesignListResultsResponseArtifactsArchive
URL string

URL to download the file

formaturi
URLExpiresAt Time

When the presigned URL expires

formatdate-time
Structure SmallMoleculeDesignListResultsResponseArtifactsStructure
URL string

URL to download the file

formaturi
URLExpiresAt Time

When the presigned URL expires

formatdate-time
CreatedAt Time
formatdate-time
Metrics SmallMoleculeDesignListResultsResponseMetrics

Scoring metrics for a designed small molecule

BindingConfidence float64

Confidence that the molecule binds the target (0-1). Primary metric for hit discovery.

ComplexIplddt float64

Interface pLDDT for the complex (0-1 float). Confidence at the binding interface.

ComplexPlddt float64

pLDDT for the full complex (0-1 float).

Iptm float64

Interface predicted TM score (0-1). Confidence in relative positioning of ligand and protein.

OptimizationScore float64

Binding strength ranking score for lead optimization. Higher values indicate stronger predicted binding.

Ptm float64

Predicted TM score (0-1). Global structure quality metric.

StructureConfidence float64

Confidence in the predicted 3D structure (0-1).

Smiles string

SMILES string of the designed molecule

Warnings []SmallMoleculeDesignListResultsResponseWarningoptional

Warnings about potential quality issues with this result.

Code string

Machine-readable warning code (e.g. "low_confidence", "unusual_geometry")

Message string

Human-readable description of the warning

Get generated small molecule designs

package main

import (
  "context"
  "fmt"

  "github.com/boltz-bio/boltz-api-go"
  "github.com/boltz-bio/boltz-api-go/option"
)

func main() {
  client := boltzapi.NewClient(
    option.WithAPIKey("My API Key"),
  )
  page, err := client.SmallMolecule.Design.ListResults(
    context.TODO(),
    "id",
    boltzapi.SmallMoleculeDesignListResultsParams{

    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", page)
}
{
  "data": [
    {
      "id": "id",
      "artifacts": {
        "archive": {
          "url": "https://example.com",
          "url_expires_at": "2019-12-27T18:11:19.117Z"
        },
        "structure": {
          "url": "https://example.com",
          "url_expires_at": "2019-12-27T18:11:19.117Z"
        }
      },
      "created_at": "2019-12-27T18:11:19.117Z",
      "metrics": {
        "binding_confidence": 0,
        "complex_iplddt": 0,
        "complex_plddt": 0,
        "iptm": 0,
        "optimization_score": 0,
        "ptm": 0,
        "structure_confidence": 0
      },
      "smiles": "smiles",
      "warnings": [
        {
          "code": "code",
          "message": "message"
        }
      ]
    }
  ],
  "first_id": "first_id",
  "has_more": true,
  "last_id": "last_id"
}
Returns Examples
{
  "data": [
    {
      "id": "id",
      "artifacts": {
        "archive": {
          "url": "https://example.com",
          "url_expires_at": "2019-12-27T18:11:19.117Z"
        },
        "structure": {
          "url": "https://example.com",
          "url_expires_at": "2019-12-27T18:11:19.117Z"
        }
      },
      "created_at": "2019-12-27T18:11:19.117Z",
      "metrics": {
        "binding_confidence": 0,
        "complex_iplddt": 0,
        "complex_plddt": 0,
        "iptm": 0,
        "optimization_score": 0,
        "ptm": 0,
        "structure_confidence": 0
      },
      "smiles": "smiles",
      "warnings": [
        {
          "code": "code",
          "message": "message"
        }
      ]
    }
  ],
  "first_id": "first_id",
  "has_more": true,
  "last_id": "last_id"
}