SWISS-MODEL REST API

# Install the command line client
$pipinstallcoreapi-cli

<!-- Load the JavaScript client library --><scriptsrc="/static/rest_framework/js/coreapi-0.1.1.js"></script><scriptsrc="/coreapi/schema.js"></script>

# Install the Python client library
$pipinstallcoreapi

alignment

create

POST/alignment/

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`target_sequences`required	Amino acid sequence as a string, or as a list for hetero targets ["sequence","sequence",...]
`template_sequence`required	Template sequence
`template_seqres_offset`required	Offset of the provided template_sequence on the seqres (defined as the mmCIF entity_poly_seq category).
`pdb_id`required	PDB ID of the template
`auth_asym_id`required	PDB author chain name
`assembly_id`	Biounit assembly ID
`project_title`

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionalignmentcreate-ptarget_sequences=...-ptemplate_sequence=...-ptemplate_seqres_offset=...-ppdb_id=...-pauth_asym_id=...-passembly_id=...-pproject_title=...

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["alignment","create"]varparams={target_sequences:...,template_sequence:...,template_seqres_offset:...,pdb_id:...,auth_asym_id:...,assembly_id:...,project_title:...,}client.action(schema,action,params).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["alignment","create"]params={"target_sequences":...,"template_sequence":...,"template_seqres_offset":...,"pdb_id":...,"auth_asym_id":...,"assembly_id":...,"project_title":...,}result=client.action(schema,action,params=params)

api-token-auth

create

POST/api-token-auth/

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`username`required	Valid username for authentication
`password`required	Valid password for authentication

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionapi-token-authcreate-pusername=...-ppassword=...

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["api-token-auth","create"]varparams={username:...,password:...,}client.action(schema,action,params).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["api-token-auth","create"]params={"username":...,"password":...,}result=client.action(schema,action,params=params)

atlas

results > read

GET/atlas/results/{md5}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`md5`required

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionatlasresultsread-pmd5=...

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["atlas","results &gt; read"]varparams={md5:...,}client.action(schema,action,params).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["atlas","results &gt; read"]params={"md5":...,}result=client.action(schema,action,params=params)

search > create

POST/atlas/search/

Start a new search on atlas data.

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`query`required	Sequence as string / PDB structure as string

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionatlassearchcreate-pquery=...

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["atlas","search &gt; create"]varparams={query:...,}client.action(schema,action,params).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["atlas","search &gt; create"]params={"query":...,}result=client.action(schema,action,params=params)

automodel

create

POST/automodel/

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`target_sequences`required	Amino acid sequence as a string, or as a list for hetero targets ["sequence","sequence",...]
`project_title`

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionautomodelcreate-ptarget_sequences=...-pproject_title=...

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["automodel","create"]varparams={target_sequences:...,project_title:...,}client.action(schema,action,params).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["automodel","create"]params={"target_sequences":...,"project_title":...,}result=client.action(schema,action,params=params)

ost

compare-ligand-structures > create

POST/ost/compare-ligand-structures/

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionostcompare-ligand-structurescreate

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["ost","compare-ligand-structures &gt; create"]client.action(schema,action).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["ost","compare-ligand-structures &gt; create"]result=client.action(schema,action)

compare-results > list

GET/ost/compare-results/

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionostcompare-resultslist

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["ost","compare-results &gt; list"]client.action(schema,action).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["ost","compare-results &gt; list"]result=client.action(schema,action)

compare-structures > create

POST/ost/compare-structures/

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionostcompare-structurescreate

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["ost","compare-structures &gt; create"]client.action(schema,action).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["ost","compare-structures &gt; create"]result=client.action(schema,action)

project

models > read_1

GET/project/{project_id}/models/{model_id}.cif

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`project_id`required
`model_id`required

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionprojectmodelsread_1-pproject_id=...-pmodel_id=...

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["project","models &gt; read_1"]varparams={project_id:...,model_id:...,}client.action(schema,action,params).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["project","models &gt; read_1"]params={"project_id":...,"model_id":...,}result=client.action(schema,action,params=params)

models > read_2

GET/project/{project_id}/models/{model_id}.cif.gz

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`project_id`required
`model_id`required

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionprojectmodelsread_2-pproject_id=...-pmodel_id=...

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["project","models &gt; read_2"]varparams={project_id:...,model_id:...,}client.action(schema,action,params).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["project","models &gt; read_2"]params={"project_id":...,"model_id":...,}result=client.action(schema,action,params=params)

models > read

GET/project/{project_id}/models/{model_id}.pdb

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`project_id`required
`model_id`required

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionprojectmodelsread-pproject_id=...-pmodel_id=...

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["project","models &gt; read"]varparams={project_id:...,model_id:...,}client.action(schema,action,params).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["project","models &gt; read"]params={"project_id":...,"model_id":...,}result=client.action(schema,action,params=params)

models > read_0

GET/project/{project_id}/models/{model_id}.pdb.gz

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`project_id`required
`model_id`required

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionprojectmodelsread_0-pproject_id=...-pmodel_id=...

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["project","models &gt; read_0"]varparams={project_id:...,model_id:...,}client.action(schema,action,params).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["project","models &gt; read_0"]params={"project_id":...,"model_id":...,}result=client.action(schema,action,params=params)

models > full-details > read

GET/project/{project_id}/models/full-details/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`project_id`required

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionprojectmodelsfull-detailsread-pproject_id=...

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["project","models &gt; full-details &gt; read"]varparams={project_id:...,}client.action(schema,action,params).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["project","models &gt; full-details &gt; read"]params={"project_id":...,}result=client.action(schema,action,params=params)

models > full-details > read_0

GET/project/{project_id}/models/full-details/{model_id}

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`project_id`required
`model_id`required

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionprojectmodelsfull-detailsread_0-pproject_id=...-pmodel_id=...

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["project","models &gt; full-details &gt; read_0"]varparams={project_id:...,model_id:...,}client.action(schema,action,params).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["project","models &gt; full-details &gt; read_0"]params={"project_id":...,"model_id":...,}result=client.action(schema,action,params=params)

models > summary > read

GET/project/{project_id}/models/summary/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`project_id`required

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionprojectmodelssummaryread-pproject_id=...

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["project","models &gt; summary &gt; read"]varparams={project_id:...,}client.action(schema,action,params).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["project","models &gt; summary &gt; read"]params={"project_id":...,}result=client.action(schema,action,params=params)

projects

read

GET/projects/

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionprojectsread

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["projects","read"]client.action(schema,action).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["projects","read"]result=client.action(schema,action)

download > create

POST/projects/download/

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`coordinates_type`
`from_datetime`	Download projects created after from_datetime, Must be in isoformat, eg "2024-09-20T10:05:20"
`to_datetime`	Download projects created before to_datetime, Must be in isoformat, eg "2024-09-22T12:12:20"

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionprojectsdownloadcreate-pcoordinates_type=...-pfrom_datetime=...-pto_datetime=...

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["projects","download &gt; create"]varparams={coordinates_type:...,from_datetime:...,to_datetime:...,}client.action(schema,action,params).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["projects","download &gt; create"]params={"coordinates_type":...,"from_datetime":...,"to_datetime":...,}result=client.action(schema,action,params=params)

download > read

GET/projects/download/{download_id}/

Obtain a download URL for the packaged data file (if status for download_id is COMPLETED). The package .zip will remain on our file system for up to 2 days.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`download_id`required

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionprojectsdownloadread-pdownload_id=...

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["projects","download &gt; read"]varparams={download_id:...,}client.action(schema,action,params).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["projects","download &gt; read"]params={"download_id":...,}result=client.action(schema,action,params=params)

user_template

create

POST/user_template/

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`template_coordinates`required
`target_sequences`required	Amino acid sequence as a string, or as a list for hetero targets ["sequence","sequence",...]
`project_title`

# Load the schema document
$coreapigethttps://swissmodel.expasy.org/coreapi/

# Interact with the API endpoint
$coreapiactionuser_templatecreate-ptemplate_coordinates=...-ptarget_sequences=...-pproject_title=...

varcoreapi=window.coreapi// Loaded by `coreapi.js`varschema=window.schema// Loaded by `schema.js`// Initialize a clientvarclient=newcoreapi.Client()// Interact with the API endpointvaraction=["user_template","create"]varparams={template_coordinates:...,target_sequences:...,project_title:...,}client.action(schema,action,params).then(function(result){// Return value is in 'result'})

importcoreapi# Initialize a client & load the schema documentclient=coreapi.Client()schema=client.get("https://swissmodel.expasy.org/coreapi/")# Interact with the API endpointaction=["user_template","create"]params={"template_coordinates":...,"target_sequences":...,"project_title":...,}result=client.action(schema,action,params=params)