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.
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 API Executions API
version: 1.0.0
servers:
- url: https://app.collaborativedrug.com/api/v1
security:
- ApiKeyAuth: []
tags:
- description: Track asynchronous API request executions
name: API Executions
paths:
/vaults/{vault_id}/api_executions:
get:
description: Return the API usage (both async and sync) in seconds between a particular timeframe. Use after and before parameters to specify a date range. By default and if before is used with no after, the previous 30 days are returned. The time returned is for the current API key only.
operationId: get_api_executions
parameters:
- in: path
name: vault_id
required: true
schema:
$ref: '#/components/schemas/vault_id'
- description: Start of the date range (YYYY-MM-DDThh:mm:ss±hh:mm). Defaults to 30 days before `before` when omitted.
in: query
name: after
required: false
schema:
format: date-time
type: string
- description: End of the date range (YYYY-MM-DDThh:mm:ss±hh:mm). Defaults to the current date and time when omitted.
in: query
name: before
required: false
schema:
format: date-time
type: string
responses:
'200':
content:
application/json:
schema:
additionalProperties:
properties:
after:
description: Start of the measured range.
example: '2023-01-01T07:00:00.000Z'
format: date-time
type: string
before:
description: End of the measured range. Only present when the `before` query parameter was supplied on the request.
example: '2023-01-22T08:12:34.000Z'
format: date-time
type: string
seconds:
description: Total API time used in the range, in seconds.
example: 20.3
type: number
type: object
description: A single-entry object whose key is the name of the API key used for the request (it is the key's name, not a fixed field called `api-key-name`).
example:
My API key:
after: '2023-01-01T07:00:00.000Z'
before: '2023-01-22T08:12:34.000Z'
seconds: 20.3
type: object
description: API usage data
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/error_apikey'
description: Missing or invalid API key
summary: API usage in seconds
tags:
- API Executions
components:
schemas:
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