beta-test-2431.replit.app

{
  "type": "object",
  "properties": {
    "cancerId": {
      "type": "string",
      "maxLength": 80,
      "description": "The person's cancer type. Accepts this app's catalogue id, the display label, or any recognised alternative wording — \"AML\", \"acute myeloid leukemia\" and \"acute-myeloid-leukemia\" all resolve to the same entry. Matching is exact, never approximate: an unrecognised value is rejected with the reason rather than guessed at, because searching the wrong disease is worse than searching nothing. Use \"other-not-listed\" when the person's cancer is not in the catalogue, and put their own wording in 'condition'."
    },
    "cancerStage": {
      "type": "string",
      "enum": [
        "unspecified",
        "0",
        "I",
        "II",
        "III",
        "IV"
      ],
      "description": "Cancer stage as the person was told it. Used to hide studies whose published criteria state a stage that excludes it; studies stating no stage are always kept. Leave 'unspecified' unless the person actually stated a stage — never infer one."
    },
    "netTreatments": {
      "type": "array",
      "maxItems": 39,
      "items": {
        "type": "string",
        "maxLength": 80
      },
      "description": "Treatments the person has already received, from the neuroendocrine tumor catalogue. Accepts catalogue ids, generic names or brand names (\"everolimus\", \"Afinitor\"). Only meaningful when cancerId is the neuroendocrine entry. Used to flag or withhold studies whose exclusion criteria name one of them; never to state that anyone is ineligible."
    },
    "condition": {
      "type": "string",
      "maxLength": 200,
      "description": "The person's own wording for their cancer. Used only when cancerId is \"other-not-listed\"; otherwise the catalogue entry supplies the search term."
    },
    "age": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 0,
      "maximum": 120,
      "description": "Age in whole years. Never a date of birth."
    },
    "sex": {
      "type": "string",
      "enum": [
        "unspecified",
        "male",
        "female"
      ],
      "description": "Only set this when the person volunteers it; many trials do not restrict by sex."
    },
    "city": {
      "type": "string",
      "maxLength": 100,
      "description": "City name only."
    },
    "state": {
      "type": "string",
      "maxLength": 100,
      "description": "State, province or region. When the country is the United States this must name a real state, district or territory — the full name, the two-letter code, or a common short form (\"Illinois\", \"IL\", \"Ill\") — because the person's own form only lets them choose from a fixed list. An unrecognised US state is rejected rather than stored. For any other country this is free text, as it is for the person."
    },
    "country": {
      "type": "string",
      "maxLength": 100,
      "description": "Country name, e.g. United States."
    },
    "travelDistanceMiles": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 1,
      "maximum": 3000,
      "description": "How far the person is willing to travel to a study site, in miles."
    },
    "recruitmentStatuses": {
      "type": "array",
      "minItems": 1,
      "maxItems": 1,
      "items": {
        "type": "string",
        "enum": [
          "RECRUITING"
        ]
      },
      "description": "Which enrolling statuses to search. Defaults to RECRUITING alone, which is what someone trying to join a study almost always wants. NOT_YET_RECRUITING covers studies that are registered but not yet open, so it is useful for planning ahead rather than enrolling today. Studies that are completed, terminated, withdrawn, suspended, active-not-recruiting or enrolling-by-invitation cannot be searched, because a participant cannot enrol in them."
    },
    "phases": {
      "type": "array",
      "maxItems": 6,
      "items": {
        "type": "string",
        "enum": [
          "EARLY_PHASE1",
          "PHASE1",
          "PHASE2",
          "PHASE3",
          "PHASE4",
          "NA"
        ]
      },
      "description": "Preferred trial phases. Leave empty to include all phases."
    },
    "priorTreatments": {
      "type": "array",
      "maxItems": 25,
      "items": {
        "type": "string",
        "maxLength": 120
      },
      "description": "Treatments the person says they have already received. Used only to flag mentions in eligibility text."
    },
    "keywords": {
      "type": "string",
      "maxLength": 200,
      "description": "Additional free-text search keywords, e.g. a biomarker or drug class."
    }
  },
  "additionalProperties": false
}