API Documentation

List endpoints paginate with cursor (1-indexed page) and limit (max 100). The common page/pageSize aliases are also accepted. Walking every page returns the full collection. The response includes a meta object with pagination details.

Query Parameters

Pagination Response

{
  "meta": {
    "pagination": {
      "page": 1,
      "pageSize": 10,
      "total": 42,
      "pageCount": 5,
      "self": "https://future-science.org/api/v1/public/contributions?cursor=1&limit=10",
      "first": "https://future-science.org/api/v1/public/contributions?cursor=1&limit=10",
      "last": "https://future-science.org/api/v1/public/contributions?cursor=5&limit=10",
      "next": "https://future-science.org/api/v1/public/contributions?cursor=2&limit=10",
      "prev": null
    }
  }
}

Each list response also includes absolute navigation links — self, first, last, next and prev (next/prev are null at the ends) — so you can walk the whole collection without building URLs by hand.

Pass ?include=content to contribution endpoints to inline each paper's manuscript as markdown under a content field, read directly from object storage. content is null when no manuscript file exists. Content pages are heavier, so limit defaults to 20 and is capped at 50, and these responses are never cached. File URLs (submittedFiles.file.url and cover.url) are returned as absolute URLs.

GET /api/v1/public/contributions/:id?include=content

{
  "data": {
    "id": 10,
    "documentId": "xyz789abc012",
    "title": "Toward Open Peer Review",
    "submittedFiles": {
      "file": { "url": "https://future-science.org/strapi/uploads/paper.md" }
    },
    "content": "# Toward Open Peer Review\n\n..."
  }
}

The global GET /contributions endpoint can be narrowed to a single initiative using Strapi-style bracketed filter parameters. Filter by the initiative slug, documentId, or numeric id (only the $eq operator is supported):

GET /api/v1/public/contributions?filters[initiative][slug][$eq]=mirror
GET /api/v1/public/contributions?filters[initiative][documentId][$eq]=abc123def456
GET /api/v1/public/contributions?filters[initiative][id][$eq]=12

The filter is applied server-side and reflected in the total and pageCount, and is preserved across the pagination links. A filter that matches nothing returns an empty data array with total 0 (a normal 200, not an error). The same initiative a contribution is filtered by is the one returned in its initiative field.

Request

GET /api/v1/public/initiatives?cursor=1&limit=2

Response

{
  "data": [
    {
      "id": 1,
      "documentId": "abc123def456",
      "title": "Archive of Academic Commentary",
      "type": "Open Review Archive",
      "presentation": "An open archive for...",
      "logo": { "url": "/uploads/logo.png" },
      "leadEditor": {
        "firstName": "Jane",
        "lastName": "Doe",
        "institution": "University of Example"
      },
      "editorialBoard": [...],
      "publishedAt": "2025-06-15T10:30:00.000Z"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "pageSize": 2,
      "total": 8,
      "pageCount": 4
    }
  }
}

When a resource is not found, the API returns a 404 status with an error message:

// 404 Not Found
{
  "error": "Initiative not found"
}

// 404 Not Found
{
  "error": "Contribution not found"
}

The public API has no strict rate limits, but please use it responsibly. Excessive automated requests may be throttled.