Skip to main content
Search lets you quickly find resources across your organization without querying each endpoint individually. A single query returns matching projects, studies, simulations, models, parameterized models, optimizations, optimization templates, experiment templates, pipelines, cell specifications, and materials.
Search is currently available through the REST API only. A search bar in Ionworks Studio is planned but not yet released.
Resource typeExamples of what’s matched
ProjectsProject names and descriptions
StudiesStudy names within projects you can access
SimulationsSimulation names and metadata
ModelsModel names and descriptions
Parameterized modelsParameterized model names
OptimizationsOptimization run names
Optimization templatesBuilt-in and custom template names
Experiment templatesBuilt-in and custom protocol templates
PipelinesPipeline names and descriptions
Cell specificationsCell names, chemistries, and identifiers
MaterialsAnode, cathode, and electrolyte materials
Search matches against names, descriptions, and other identifying fields for each resource type. Results are scoped to your current organization and respect your project-level permissions — you only see resources you have access to.

​
Using search via the API

Search is available at the /search endpoint. See the API Reference for the full request and response schema. A typical request specifies the query string and returns matches grouped by resource type: 
curl -X GET "https://api.ionworks.com/search?q=NMC622" \
  -H "Authorization: Bearer $IONWORKS_API_KEY"
Results are filtered to the resources your API key has access to.
Search is useful when you remember a partial name (for example, a cell chemistry, a customer name, or a protocol keyword) but don’t know which project or study contains it.
Search uses Postgres full-text indexing on the server, so queries return fast even as your organization accumulates many resources. Indexes are maintained automatically — there is nothing to configure.