Celestia Subscribe API

The Subscribe API from Celestia — 1 operation(s) for subscribe.

Operations 1

POST /api/subscribe/ Subscribe to the newsletter #

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/celestia:celestia-subscribe-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

celestia-subscribe-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Celestia Website Subscribe API
  version: 1.0.0
  description: HTTP endpoints for the Celestia marketing website. This is not the Celestia blockchain Node API. Use https://docs.celestia.org/build/rpc/node-api/ for the node JSON-RPC API, authentication, and OpenRPC schemas. Contact and newsletter submissions require user consent; newsletter subscriptions also require browser reCAPTCHA.
servers:
- url: https://celestia.org
security: []
tags:
- name: Subscribe
paths:
  /api/subscribe/:
    post:
      operationId: subscribeToWebsiteNewsletter
      summary: Subscribe to the newsletter
      description: Subscribes a consenting email owner through Mailchimp after server-side reCAPTCHA verification. No API key is required from clients. Service credentials remain server-side.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubscriptionInput'
      responses:
        '200':
          description: Submission accepted. Read any message for delivery caveats.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Success'
        '400':
          $ref: '#/components/responses/Error'
        '405':
          $ref: '#/components/responses/Error'
        '408':
          $ref: '#/components/responses/Error'
        '500':
          $ref: '#/components/responses/Error'
        '429':
          description: Upstream newsletter provider is rate limited. Wait before retrying.
          headers:
            Retry-After:
              description: Provider delay in seconds or HTTP date; defaults to 60 seconds when absent.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          $ref: '#/components/responses/Error'
      tags:
      - Subscribe
components:
  schemas:
    Error:
      type: object
      required:
      - error
      - code
      - hint
      properties:
        error:
          type: string
          description: Human-readable error message; retained for form clients.
        code:
          type: string
          description: Stable machine-readable error identifier.
        hint:
          type: string
          description: Suggested action to resolve the error.
    Success:
      type: object
      required:
      - success
      properties:
        success:
          type: boolean
          const: true
        message:
          type: string
    SubscriptionInput:
      type: object
      required:
      - email
      - token
      properties:
        email:
          type: string
          format: email
          minLength: 3
          maxLength: 320
          description: Email address whose owner consented to subscribe.
        token:
          type: string
          minLength: 1
          description: A fresh reCAPTCHA token obtained through the website newsletter form. Automated clients must not bypass this requirement.
  responses:
    Error:
      description: Request failed. Read code and hint before retrying.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
externalDocs:
  description: Authentication, examples, errors, and rate-limit behavior
  url: https://celestia.org/api-docs.md
x-provenance:
  method: harvested
  publisher: Celestia
  source: https://celestia.org/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)