My Noticeboard

Tell My Noticeboard where local community activity is announced: the address of a group’s own website, a parish, library or venue programme, or an iCal feed. We read the page ourselves; nothing is published on your word. Community-led and voluntary activity only. Needs an API key. Returns a receipt; repeat a call with the same idempotency_key to get the same receipt.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 8,
      "maxLength": 500,
      "description": "The page or feed address, starting https://"
    },
    "about": {
      "description": "Who publishes it or what it covers, e.g. \"Bridport Library events\".",
      "type": "string",
      "maxLength": 200
    },
    "note": {
      "description": "Anything that helps a curator, e.g. \"lists the community choir’s rehearsals\".",
      "type": "string",
      "maxLength": 1000
    },
    "idempotency_key": {
      "description": "Any string you choose; a retry with the same key returns the first receipt.",
      "type": "string",
      "maxLength": 100
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find community groups, charities and support services by need and place. Returns ranked listings with distance and when each was last checked.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "What the person needs, in their words, e.g. \"dementia support\" or \"walking group for men\"."
    },
    "near": {
      "description": "Town, village or UK postcode, e.g. \"Bridport\" or \"DT6 3NN\".",
      "type": "string",
      "maxLength": 60
    },
    "radius_km": {
      "description": "Search radius in km (default 10).",
      "type": "number",
      "minimum": 1,
      "maximum": 50
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Full details for one service: description, how to get help, contacts, opening times, address and when it was last checked.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 200,
      "description": "The service id or slug from search_services."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Sessions and activities happening at a time and place. Accepts a plain-English question such as "what can I do today in Bridport?" or "what's on next week for housebound people?". Cancelled dates are included and marked.

{
  "type": "object",
  "properties": {
    "question": {
      "description": "A plain-English question; other fields override what it implies.",
      "type": "string",
      "maxLength": 200
    },
    "when": {
      "type": "string",
      "enum": [
        "now",
        "today",
        "tonight",
        "tomorrow",
        "weekend",
        "week",
        "next-week"
      ]
    },
    "near": {
      "description": "Town, village or postcode.",
      "type": "string",
      "maxLength": 60
    },
    "for_people_at_home": {
      "description": "Only phone, online and home-visit sessions, or ones for housebound people.",
      "type": "boolean"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

A ready-made set of the best local, area-wide and national services plus resources for one topic, as a link worker would print.

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "A topic code from list_categories (e.g. \"dementia\") or plain words."
    },
    "near": {
      "description": "Town or postcode for the local section.",
      "type": "string",
      "maxLength": 60
    }
  },
  "required": [
    "topic"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The topics (themes and the needs under them) used to tag listings. Codes work as the topic for get_resource_sheet.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}