digitalpublic-com Trials API

The Trials API from digitalpublic-com — 3 operation(s) for trials.

Operations 3

POST /trials Start a 14-day real-data trial with supervised writing and no card #
GET /trials/{trialId} Get non-sensitive live-trial state and next action #
POST /trials/{trialId}/upgrade Create a human Stripe checkout that preserves the trial account and project #

Specifications

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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/digitalpublic-com:digitalpublic-com-trials-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

digitalpublic-com-trials-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: DigitalPublic Commercial Trials API
  version: 2026-09-10-trial-active-projects-v1
  description: Public API for discovering DigitalPublic operational marketing capabilities, legal identity, trust, data processing, plans, connection requirements, illustrative use cases, time-value ROI, service status, and human-authorized onboarding. It contains no customer data and makes no marketing performance guarantees.
servers:
- url: https://platform.digitalpublic.com/api/commercial
tags:
- name: Trials
paths:
  /trials:
    post:
      operationId: startLiveTrial
      summary: Start a 14-day real-data trial with supervised writing and no card
      description: Creates an idempotent pending trial with an initial real project (up to three active projects), 2,000 total units, one user, and up to five connected tools. One passwordless email verifies identity, establishes the session and resumes provisioning.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - email
              - runtime
              - idempotencyKey
              properties:
                email:
                  type: string
                  format: email
                company:
                  type: string
                  maxLength: 160
                projectName:
                  type: string
                  maxLength: 160
                projectUrl:
                  type: string
                  maxLength: 2000
                  description: Optional domain or HTTP(S) URL. Bare domains are normalized to HTTPS.
                channels:
                  type: array
                  items:
                    type: string
                  default: []
                locale:
                  type: string
                  enum:
                  - es
                  - en
                runtime:
                  type: string
                  maxLength: 80
                idempotencyKey:
                  type: string
                  minLength: 8
                  maxLength: 160
      responses:
        '201':
          description: Trial created with a limited status token and HUMAN_VERIFY_EMAIL next action
        '409':
          description: Trial already used or idempotency conflict
        '429':
          description: IP, email, or domain rate limit reached
      tags:
      - Trials
  /trials/{trialId}:
    get:
      operationId: getLiveTrialStatus
      summary: Get non-sensitive live-trial state and next action
      parameters:
      - in: path
        name: trialId
        required: true
        schema:
          type: string
      security:
      - statusToken: []
      responses:
        '200':
          description: State, expiry, unit and connection limits, modules and safe human links
        '401':
          description: Status token required
        '404':
          description: Unknown trial or invalid token
      tags:
      - Trials
  /trials/{trialId}/upgrade:
    post:
      operationId: upgradeLiveTrial
      summary: Create a human Stripe checkout that preserves the trial account and project
      parameters:
      - in: path
        name: trialId
        required: true
        schema:
          type: string
      security:
      - statusToken: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - plan
              properties:
                plan:
                  type: string
                  enum:
                  - observer
                  - operator
                  - partner
      responses:
        '200':
          description: Human checkout URL
        '409':
          description: Email verification or trial account is incomplete
      tags:
      - Trials
components:
  securitySchemes:
    portalSession:
      type: apiKey
      in: cookie
      name: authjs.session-token
      description: Authenticated DigitalPublic portal session. OWNER or ADMIN membership is required.
    statusToken:
      type: http
      scheme: bearer
      description: Limited live-trial status token. It cannot access projects, provider data, or operational DigitalPublic tools.