Collaborative Drug Discovery Exports API
Asynchronous data exports
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/collaborative-drug-discovery:collaborative-drug-discovery-exports-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
contact:
url: https://support.collaborativedrug.com/hc/en-us/requests/new
description: 'Collaborative Drug Discovery provides an API (Application Programming
Interface) that can be used for secure programmatic access to your vault
data.'
license:
name: Proprietary
url: https://support.collaborativedrug.com/hc/en-us/requests/new
title: CDD Exports API
version: 1.0.0
servers:
- url: https://app.collaborativedrug.com/api/v1
security:
- ApiKeyAuth: []
tags:
- description: Asynchronous data exports
name: Exports
paths:
/vaults/{vault_id}/export_progress/{export_id}:
get:
description: Check on the status of your export task. Repeat this call every 5-10 seconds (suggested interval) until the status is “finished”
operationId: export_progress
parameters:
- in: path
name: vault_id
required: true
schema:
$ref: '#/components/schemas/vault_id'
- in: path
name: export_id
required: true
schema:
description: Numeric identifier of the export
type: integer
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/export'
description: Successful operation
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/error_apikey'
description: Missing or invalid API key
'404':
content:
application/json:
schema:
properties:
error:
default: Couldn't find export with 'id'={export_id}
type: object
description: Couldn't find this export
summary: Get progress of an export
tags:
- Exports
/vaults/{vault_id}/exports:
get:
description: 'Check how many async API export tasks are currently running and see the current status of the user''s queue. The endpoint does not accept any normal API parameters and lists all of a user''s exports, including any exports initiated via the GUI/front-end. Note: This GET Exports API call will return ALL exports across all Vaults applicable to the API Token specified, regardless of the Vault ID used in the API url.'
operationId: check_all_exports
parameters:
- in: path
name: vault_id
required: true
schema:
$ref: '#/components/schemas/vault_id'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/exports'
description: List of all active exports
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/error_apikey'
description: Missing or invalid API key
summary: Check All Current Exports
tags:
- Exports
/vaults/{vault_id}/exports/{export_id}:
delete:
description: Cancels an export if possible
operationId: cancel_export
parameters:
- in: path
name: vault_id
required: true
schema:
$ref: '#/components/schemas/vault_id'
- in: path
name: export_id
required: true
schema:
description: Numeric identifier of the export
type: integer
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/export'
description: The export was canceled (its `status` becomes `canceled`).
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/error_apikey'
description: Missing or invalid API key
'405':
content:
application/json:
schema:
$ref: '#/components/schemas/export'
description: The export was not in a cancelable state (for example it has already finished or was already canceled). The export's current state is returned unchanged.
summary: Cancel Export
tags:
- Exports
get:
description: 'Retrieve the output of an export once it is ready. An export is created whenever a query endpoint is called with async=true (for example `POST /molecules/query`, `POST /batches/query`, or an ELN entries query), as well as when running a saved search. This single endpoint returns the finished output for any of them. If the export is not finished it returns `403` together with the export''s async progress details; poll `GET /export_progress/{export_id}` until it is ready. The output format (JSON, CSV, SDF, etc.) depends on the format requested when the export was created.
Depending on server configuration the file may be served directly (`200`) or via a `302` redirect to a temporary download URL (e.g. S3). Configure your client to follow redirects — with curl, pass `-L`.'
operationId: exports
parameters:
- in: path
name: vault_id
required: true
schema:
$ref: '#/components/schemas/vault_id'
- in: path
name: export_id
required: true
schema:
description: Numeric identifier of the export
type: integer
responses:
'200':
description: Successful operation; the response body is the export file. The format depends on what was requested when the export was created (JSON, CSV, SDF, etc.).
'302':
description: 'Redirect to a temporary download URL for the file (used when files are served directly from S3). Follow the `Location` header (curl: `-L`).'
headers:
Location:
description: Temporary URL to download the export file from.
schema:
type: string
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/error_apikey'
description: Missing or invalid API key
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/export'
description: The export is not ready yet
'404':
content:
application/json:
schema:
properties:
error:
default: Couldn't find export with 'id'={export_id}
type: object
description: Couldn't find this export
summary: Get the output of an export
tags:
- Exports
components:
schemas:
export:
properties:
created_at:
description: Timestamp in ISO-8601 UTC
example: '2024-01-02T03:04:05Z'
type: string
id:
example: 1
type: integer
modified_at:
description: Timestamp in ISO-8601 UTC
example: '2024-01-02T03:04:05Z'
type: string
queued_job_position:
description: Position of the export's job in the processing queue. Only present while the export is in the `new` state.
type: integer
status:
description: The export's state. While polling progress it moves `new` -> `started` -> `finished`; any value other than these three during polling means something went wrong. `canceled` is returned after a successful cancel.
enum:
- new
- started
- finished
- downloaded
- failed
- canceled
type: string
type: object
exports:
items:
$ref: '#/components/schemas/export'
type: array
error_apikey:
description: Whenever the given API key doesn't allow access to the given vault or the vault doesn't exist
properties:
code:
default: 401
type: integer
error:
default: key not authorized for access to this vault
type: string
type: object
vault_id:
description: Numeric identifier of the vault
type: integer
securitySchemes:
ApiKeyAuth:
in: header
name: X-CDD-Token
type: apiKey