API reference

Draft reference for the World Wide Public API (v1). Endpoints and envelopes may change until the API is generally available.

API overview

Endpoints

Catalog (read-only)

Conferences (workflows)

Domains

List active scientific domains (optionally with content counts).

Auth: Service principal (Authorization: Bearer)

Request

GET/api/v1/domains

Parameters

includeCounts (boolean, default true, allowed: true, false)

Include content counts per domain.

Responses

200 — Domain list

{
  "data": [
    {
      "id": "019b891c-b981-74dc-8f5c-87b1e1ec2c1e",
      "slug": "neuroscience",
      "name": "Neuroscience",
      "nickname": "Neuro",
      "description": "Research spanning cellular, systems, and computational neuroscience.",
      "sortOrder": 10,
      "counts": {
        "seminars": 120,
        "conferences": 14,
        "jobs": 52,
        "grants": 39
      }
    }
  ],
  "total": 1
}

401 — Missing service credential

{
  "error": "Authentication is required."
}

403 — Invalid service credential

{
  "error": "Authentication is required."
}

503 — Public API routes disabled

{
  "error": "Public API routes are currently disabled."
}

Example

curl "https://world-wide.org/api/v1/domains" -H "Authorization: Bearer $WW_SERVICE_TOKEN"

Notes

Base URL is versioned under /api/v1 and served from world-wide.org (apex domain).

Need help?

Contact info@world-wide.org for API access and integration support.