{
  "schema": "kallipolis.resource-quality.v1",
  "id": "resource.public-data.clinicaltrials-gov-api-v2",
  "version": "1.0.0",
  "title": "ClinicalTrials.gov API v2 boundary",
  "summary": "Official-source access, authentication, request-shaping, paging, freshness, legal, and interpretation boundaries for ClinicalTrials.gov API v2.",
  "content": {
    "kind": "public-data-api-boundary",
    "facts": [
      {
        "id": "fact.clinicaltrials.api-v2.access",
        "statement": "ClinicalTrials.gov publishes an OpenAPI-described REST API v2 for study search, individual study retrieval, metadata, and service-version discovery.",
        "normativeLevel": "informative",
        "sourceIds": [
          "source.clinicaltrials.api-v2"
        ]
      },
      {
        "id": "fact.clinicaltrials.api-v2.authentication",
        "statement": "Study search responses are paginated, and clients must retain the next-page token and requested fields rather than treating the first page as a complete result set.",
        "normativeLevel": "informative",
        "sourceIds": [
          "source.clinicaltrials.api-v2"
        ]
      },
      {
        "id": "fact.clinicaltrials.api-v2.request",
        "statement": "The service normally refreshes data on weekdays, and clients should inspect the version endpoint dataTimestamp before claiming a current snapshot.",
        "normativeLevel": "informative",
        "sourceIds": [
          "source.clinicaltrials.api-v2"
        ]
      },
      {
        "id": "fact.clinicaltrials.api-v2.boundary",
        "statement": "A registered study record is sponsor-submitted registry information, not medical advice, peer review, proof of efficacy, or evidence that every field is complete and current.",
        "normativeLevel": "informative",
        "sourceIds": [
          "source.clinicaltrials.api-v2"
        ]
      }
    ]
  },
  "language": "en",
  "category": "public-data-api",
  "state": "prepared",
  "canonicalUrl": "https://platoskallipolis.com/resources/public-data-apis/clinicaltrials-gov-api-v2.json",
  "contentHash": "sha256:e61bde269ba2ab077d84d41cc735552572b9606bc7881fa4946e87bdc2842318",
  "owner": {
    "id": "platos-kallipolis",
    "name": "Plato's Kallipolis",
    "type": "organization",
    "accountabilityUrl": "https://platoskallipolis.com/about"
  },
  "access": {
    "mode": "public",
    "url": "https://platoskallipolis.com/resources/public-data-apis/clinicaltrials-gov-api-v2.json",
    "authentication": "none",
    "robotsAllowed": true
  },
  "provenance": {
    "method": "primary-source",
    "sources": [
      {
        "id": "source.clinicaltrials.api-v2",
        "url": "https://clinicaltrials.gov/data-about-studies/learn-about-api",
        "title": "ClinicalTrials.gov API",
        "publisher": "U.S. National Library of Medicine",
        "observedAt": "2026-08-27T09:30:00Z"
      }
    ]
  },
  "observedAt": "2026-08-27T09:30:00Z",
  "freshness": {
    "policy": "max-age",
    "state": "current",
    "nextReviewAt": "2026-09-03T09:30:00Z",
    "maxAgeSeconds": 604800
  },
  "license": {
    "id": "source-terms-apply",
    "url": "https://clinicaltrials.gov/about-site/terms-conditions",
    "redistributionAllowed": false
  },
  "evidence": [
    {
      "id": "evidence.clinicaltrials.api-v2",
      "type": "source-claim",
      "url": "https://clinicaltrials.gov/data-about-studies/learn-about-api",
      "observedAt": "2026-08-27T09:30:00Z"
    }
  ]
}