{
    "openapi": "3.1.0",
    "info": {
        "title": "CouncilMonitor API",
        "version": "1.0.0 (2026-10-29)",
        "description": "Every UK council meeting, agenda item, decision and paper as JSON, each record with its official council address. Without a key: 60 requests an hour. A Pro Plus key: 250,000 a month and the full text of papers.",
        "termsOfService": "https://councilmonitor.co.uk/terms",
        "contact": {
            "url": "https://councilmonitor.co.uk/support"
        }
    },
    "externalDocs": {
        "url": "https://councilmonitor.co.uk/documentation",
        "description": "Documentation"
    },
    "servers": [
        {
            "url": "https://api.councilmonitor.co.uk/v1"
        }
    ],
    "tags": [
        {
            "name": "Councils"
        },
        {
            "name": "Meetings"
        },
        {
            "name": "Decisions"
        },
        {
            "name": "Papers"
        },
        {
            "name": "Your key"
        }
    ],
    "paths": {
        "/councils": {
            "get": {
                "operationId": "councils",
                "summary": "Every council covered, with its slug",
                "tags": [
                    "Councils"
                ],
                "externalDocs": {
                    "url": "https://councilmonitor.co.uk/documentation/councils"
                },
                "parameters": [
                    {
                        "name": "q",
                        "in": "query",
                        "required": false,
                        "description": "Words in the council's name",
                        "schema": {
                            "type": "string"
                        },
                        "example": "housing"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The records, in the envelope",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Envelope"
                                },
                                "example": {
                                    "data": [
                                        {
                                            "slug": "argyll-and-bute",
                                            "name": "Argyll and Bute",
                                            "link": "https://councilmonitor.co.uk/council/argyll-and-bute",
                                            "official_url": "https://www.argyll-bute.gov.uk/moderngov/"
                                        }
                                    ],
                                    "meta": {
                                        "count": 1
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/responses/Error"
                    },
                    "401": {
                        "$ref": "#/components/responses/Error"
                    },
                    "422": {
                        "$ref": "#/components/responses/Error"
                    },
                    "429": {
                        "$ref": "#/components/responses/Error"
                    },
                    "500": {
                        "$ref": "#/components/responses/Error"
                    }
                },
                "security": [
                    {},
                    {
                        "bearer": []
                    },
                    {
                        "apiKey": []
                    }
                ]
            }
        },
        "/councils/{slug}": {
            "get": {
                "operationId": "council",
                "summary": "One council: its name, its official site and how much of it is in the archive",
                "tags": [
                    "Councils"
                ],
                "externalDocs": {
                    "url": "https://councilmonitor.co.uk/documentation/council"
                },
                "parameters": [
                    {
                        "name": "slug",
                        "in": "path",
                        "required": true,
                        "description": "The council's slug, as /v1/councils gives it",
                        "schema": {
                            "type": "string"
                        },
                        "example": "adur-and-worthing"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The records, in the envelope",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Envelope"
                                },
                                "example": {
                                    "data": {
                                        "slug": "argyll-and-bute",
                                        "name": "Argyll and Bute",
                                        "link": "https://councilmonitor.co.uk/council/argyll-and-bute",
                                        "official_url": "https://www.argyll-bute.gov.uk/moderngov/",
                                        "meetings": 3202,
                                        "first_meeting": "1995-06-05",
                                        "last_meeting": "2026-11-17",
                                        "collected": "2026-11-17T10:39:00Z"
                                    },
                                    "meta": {}
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/responses/Error"
                    },
                    "401": {
                        "$ref": "#/components/responses/Error"
                    },
                    "404": {
                        "$ref": "#/components/responses/Error"
                    },
                    "422": {
                        "$ref": "#/components/responses/Error"
                    },
                    "429": {
                        "$ref": "#/components/responses/Error"
                    },
                    "500": {
                        "$ref": "#/components/responses/Error"
                    }
                },
                "security": [
                    {},
                    {
                        "bearer": []
                    },
                    {
                        "apiKey": []
                    }
                ]
            }
        },
        "/meetings": {
            "get": {
                "operationId": "meetings",
                "summary": "Meetings, newest first, or coming up first with upcoming=true",
                "tags": [
                    "Meetings"
                ],
                "externalDocs": {
                    "url": "https://councilmonitor.co.uk/documentation/meetings"
                },
                "parameters": [
                    {
                        "name": "council",
                        "in": "query",
                        "required": false,
                        "description": "A council slug",
                        "schema": {
                            "type": "string"
                        },
                        "example": "adur-and-worthing"
                    },
                    {
                        "name": "committee",
                        "in": "query",
                        "required": false,
                        "description": "Words in the committee's name",
                        "schema": {
                            "type": "string"
                        },
                        "example": "planning"
                    },
                    {
                        "name": "from",
                        "in": "query",
                        "required": false,
                        "description": "On or after, YYYY-MM-DD",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "example": "2026-01-01"
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "required": false,
                        "description": "On or before, YYYY-MM-DD",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "example": "2026-03-31"
                    },
                    {
                        "name": "upcoming",
                        "in": "query",
                        "required": false,
                        "description": "Only meetings from today on, soonest first",
                        "schema": {
                            "type": "boolean",
                            "default": false
                        },
                        "example": false
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "description": "Page number, from 1",
                        "schema": {
                            "type": "integer",
                            "default": 1
                        },
                        "example": 1
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "required": false,
                        "description": "Results per page, at most 100",
                        "schema": {
                            "type": "integer",
                            "default": 25
                        },
                        "example": 25
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "required": false,
                        "description": "The next_cursor from the previous answer; faster than page for walking far",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The records, in the envelope",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Envelope"
                                },
                                "example": {
                                    "data": [
                                        {
                                            "id": "mt_czxtzsef",
                                            "council": {
                                                "slug": "argyll-and-bute",
                                                "name": "Argyll and Bute"
                                            },
                                            "committee": "Planning, Protective Services and Licensing Committee",
                                            "date": "2026-11-17",
                                            "time": "10.30am",
                                            "venue": "By Microsoft Teams",
                                            "state": "today",
                                            "items": 9,
                                            "papers": 6,
                                            "link": "https://councilmonitor.co.uk/council/argyll-and-bute/meeting/2026-11-17-planning-protective-services-and-licensing-committee",
                                            "official_url": "https://www.argyll-bute.gov.uk/moderngov/ieListDocuments.aspx?MId=17135"
                                        },
                                        {
                                            "id": "mt_ca39nwh6",
                                            "council": {
                                                "slug": "argyll-and-bute",
                                                "name": "Argyll and Bute"
                                            },
                                            "committee": "Planning, Protective Services and Licensing Committee (Civic Hearings)",
                                            "date": "2026-11-17",
                                            "time": "2.30pm",
                                            "venue": "By Microsoft Teams",
                                            "state": "today",
                                            "items": 3,
                                            "papers": 0,
                                            "link": "https://councilmonitor.co.uk/council/argyll-and-bute/meeting/2026-11-17-planning-protective-services-and-licensing-committee-civic-hearings-17136",
                                            "official_url": "https://www.argyll-bute.gov.uk/moderngov/ieListDocuments.aspx?MId=17136"
                                        }
                                    ],
                                    "meta": {
                                        "count": 2,
                                        "next_cursor": "eyJvIjoyfQ",
                                        "page": 1,
                                        "per_page": 2,
                                        "total": 3194,
                                        "total_pages": 1597,
                                        "next_page": 2,
                                        "prev_page": null
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/responses/Error"
                    },
                    "401": {
                        "$ref": "#/components/responses/Error"
                    },
                    "422": {
                        "$ref": "#/components/responses/Error"
                    },
                    "429": {
                        "$ref": "#/components/responses/Error"
                    },
                    "500": {
                        "$ref": "#/components/responses/Error"
                    }
                },
                "security": [
                    {},
                    {
                        "bearer": []
                    },
                    {
                        "apiKey": []
                    }
                ]
            }
        },
        "/meetings/{id}": {
            "get": {
                "operationId": "meeting",
                "summary": "One meeting with its agenda: every item, what was decided and its papers",
                "tags": [
                    "Meetings"
                ],
                "externalDocs": {
                    "url": "https://councilmonitor.co.uk/documentation/meeting"
                },
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "The id, as the other endpoints give it",
                        "schema": {
                            "type": "string"
                        },
                        "example": "mt_hk4faxbe"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The records, in the envelope",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Envelope"
                                },
                                "example": {
                                    "data": {
                                        "id": "mt_hk4faxbe",
                                        "council": {
                                            "slug": "argyll-and-bute",
                                            "name": "Argyll and Bute"
                                        },
                                        "committee": "Helensburgh and Lomond Area Community Planning Group",
                                        "date": "2026-11-10",
                                        "time": "10.00am",
                                        "venue": "ON A HYBRID BASIS IN THE MARRIAGE SUITE, HELENSBURGH AND LOMOND CIVICI CENTRE, 38 EAST CLYDE STREET, HELENSBURGH AND BY MICROSOFT TEAMS",
                                        "state": "held",
                                        "items": 32,
                                        "papers": 14,
                                        "link": "https://councilmonitor.co.uk/council/argyll-and-bute/meeting/2026-11-10-helensburgh-and-lomond-area-community-planning-group",
                                        "official_url": "https://www.argyll-bute.gov.uk/moderngov/ieListDocuments.aspx?MId=17114",
                                        "agenda": [
                                            {
                                                "id": "it_bdghatnk",
                                                "number": "1",
                                                "title": "WELCOME AND APOLOGIES",
                                                "outcome": null,
                                                "decision": null,
                                                "papers": [],
                                                "link": null
                                            },
                                            {
                                                "id": "it_q2yess1d",
                                                "number": "2",
                                                "title": "DECLARATIONS OF INTEREST",
                                                "outcome": null,
                                                "decision": null,
                                                "papers": [],
                                                "link": null
                                            },
                                            {
                                                "id": "it_6evgnbqh",
                                                "number": "3",
                                                "title": "MINUTES OF THE HELENSBURGH AND LOMOND COMMUNITY PLANNING GROUP HELD ON 18 AUGUST 2026",
                                                "outcome": null,
                                                "decision": null,
                                                "papers": [
                                                    {
                                                        "id": "pp_6mm0nmer",
                                                        "title": "MINUTES OF THE HELENSBURGH AND LOMOND COMMUNITY PLANNING GROUP HELD ON 18 AUGUST 2026",
                                                        "kind": "minutes",
                                                        "pages": null,
                                                        "text": "read",
                                                        "link": "https://councilmonitor.co.uk/council/argyll-and-bute/meeting/2026-11-10-helensburgh-and-lomond-area-community-planning-group/papers/a59f709c5732/minutes-of-the-helensburgh-and-lomond-community-planning-group-held-on-18-august.pdf",
                                                        "official_url": "https://www.argyll-bute.gov.uk/moderngov/documents/s236218/Minutes%2018082026%20Helensburgh%20and%20Lomond%20Area%20Community%20Planning%20Group.pdf"
                                                    }
                                                ],
                                                "link": null
                                            }
                                        ]
                                    },
                                    "meta": {}
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/responses/Error"
                    },
                    "401": {
                        "$ref": "#/components/responses/Error"
                    },
                    "404": {
                        "$ref": "#/components/responses/Error"
                    },
                    "422": {
                        "$ref": "#/components/responses/Error"
                    },
                    "429": {
                        "$ref": "#/components/responses/Error"
                    },
                    "500": {
                        "$ref": "#/components/responses/Error"
                    }
                },
                "security": [
                    {},
                    {
                        "bearer": []
                    },
                    {
                        "apiKey": []
                    }
                ]
            }
        },
        "/items/{id}": {
            "get": {
                "operationId": "item",
                "summary": "One agenda item: the decision in the council's words, the minutes and its papers",
                "tags": [
                    "Meetings"
                ],
                "externalDocs": {
                    "url": "https://councilmonitor.co.uk/documentation/item"
                },
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "The id, as the other endpoints give it",
                        "schema": {
                            "type": "string"
                        },
                        "example": "it_8b708b48"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The records, in the envelope",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Envelope"
                                },
                                "example": {
                                    "data": {
                                        "id": "it_8b708b48",
                                        "meeting": {
                                            "id": "mt_hk4faxbe",
                                            "council": {
                                                "slug": "argyll-and-bute",
                                                "name": "Argyll and Bute"
                                            },
                                            "committee": "Helensburgh and Lomond Area Community Planning Group",
                                            "date": "2026-11-10",
                                            "time": "10.00am",
                                            "venue": "ON A HYBRID BASIS IN THE MARRIAGE SUITE, HELENSBURGH AND LOMOND CIVICI CENTRE, 38 EAST CLYDE STREET, HELENSBURGH AND BY MICROSOFT TEAMS",
                                            "state": "held",
                                            "items": 32,
                                            "papers": 14,
                                            "link": "https://councilmonitor.co.uk/council/argyll-and-bute/meeting/2026-11-10-helensburgh-and-lomond-area-community-planning-group",
                                            "official_url": "https://www.argyll-bute.gov.uk/moderngov/ieListDocuments.aspx?MId=17114"
                                        },
                                        "number": "8a",
                                        "title": "Police Scotland Update",
                                        "outcome": "noted",
                                        "decision": "Decision The Helensburgh and Lomond Area Community Planning Group noted the information provided. (Reference: Report by Police Scotland dated October/November 2026, submitted)",
                                        "minutes": "The Group gave consideration to a report highlighting Police Scotland’s priorities for the Cowal, Bute and Helensburgh area including information on acquisitive crime; road safety; anti-social behaviour and violent crime; public protection; the rural partners day; fraud and scam ...",
                                        "papers": [
                                            {
                                                "id": "pp_29qe3n61",
                                                "title": "Police Scotland Update",
                                                "kind": "report",
                                                "pages": null,
                                                "text": "read",
                                                "link": "https://councilmonitor.co.uk/council/argyll-and-bute/meeting/2026-11-10-helensburgh-and-lomond-area-community-planning-group/papers/20616c463c0d/police-scotland-update.pdf",
                                                "official_url": "https://www.argyll-bute.gov.uk/moderngov/documents/s236005/Police%20Scotland%20NOV%202026.pdf"
                                            }
                                        ],
                                        "link": "https://councilmonitor.co.uk/council/argyll-and-bute/meeting/2026-11-10-helensburgh-and-lomond-area-community-planning-group/item/8a"
                                    },
                                    "meta": {}
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/responses/Error"
                    },
                    "401": {
                        "$ref": "#/components/responses/Error"
                    },
                    "404": {
                        "$ref": "#/components/responses/Error"
                    },
                    "422": {
                        "$ref": "#/components/responses/Error"
                    },
                    "429": {
                        "$ref": "#/components/responses/Error"
                    },
                    "500": {
                        "$ref": "#/components/responses/Error"
                    }
                },
                "security": [
                    {},
                    {
                        "bearer": []
                    },
                    {
                        "apiKey": []
                    }
                ]
            }
        },
        "/decisions": {
            "get": {
                "operationId": "decisions",
                "summary": "Decisions councils have recorded, newest first, or best match first with q",
                "tags": [
                    "Decisions"
                ],
                "externalDocs": {
                    "url": "https://councilmonitor.co.uk/documentation/decisions"
                },
                "parameters": [
                    {
                        "name": "q",
                        "in": "query",
                        "required": false,
                        "description": "Words in the item or its decision",
                        "schema": {
                            "type": "string"
                        },
                        "example": "housing"
                    },
                    {
                        "name": "council",
                        "in": "query",
                        "required": false,
                        "description": "A council slug",
                        "schema": {
                            "type": "string"
                        },
                        "example": "adur-and-worthing"
                    },
                    {
                        "name": "from",
                        "in": "query",
                        "required": false,
                        "description": "On or after, YYYY-MM-DD",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "example": "2026-01-01"
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "required": false,
                        "description": "On or before, YYYY-MM-DD",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "example": "2026-03-31"
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "description": "Page number, from 1",
                        "schema": {
                            "type": "integer",
                            "default": 1
                        },
                        "example": 1
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "required": false,
                        "description": "Results per page, at most 100",
                        "schema": {
                            "type": "integer",
                            "default": 25
                        },
                        "example": 25
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "required": false,
                        "description": "The next_cursor from the previous answer; faster than page for walking far",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The records, in the envelope",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Envelope"
                                },
                                "example": {
                                    "data": [
                                        {
                                            "item": "it_cwptadjr",
                                            "meeting": "mt_5h4ndz14",
                                            "council": {
                                                "slug": "argyll-and-bute",
                                                "name": "Argyll and Bute"
                                            },
                                            "committee": "Argyll and Bute Local Review Body",
                                            "date": "2026-11-10",
                                            "number": "3",
                                            "title": "Consider notice of review request: inveraray shinty club, dalmally road, inveraray, pa32 8xd (ref: 26/0006/lrb)",
                                            "outcome": "agreed",
                                            "decision": "Decision The Members of the LRB agreed to adjourn the meeting to allow Members time to seek advice on the preparation of a competent Motion to approve the application subject to mitigation measures being put in place to reduce the impact the proposed development would have on the...",
                                            "link": "https://councilmonitor.co.uk/council/argyll-and-bute/meeting/2026-11-10-argyll-and-bute-local-review-body/item/3"
                                        },
                                        {
                                            "item": "it_pwpmq5nn",
                                            "meeting": "mt_hk4faxbe",
                                            "council": {
                                                "slug": "argyll-and-bute",
                                                "name": "Argyll and Bute"
                                            },
                                            "committee": "Helensburgh and Lomond Area Community Planning Group",
                                            "date": "2026-11-10",
                                            "number": "4",
                                            "title": "Helensburgh and lomond youth action council",
                                            "outcome": "noted",
                                            "decision": "Decision The Helensburgh and Lomond Area Community Planning Group noted the presentation. (Reference: Presentation by Helensburgh and Lomond Youth Action Council)",
                                            "link": "https://councilmonitor.co.uk/council/argyll-and-bute/meeting/2026-11-10-helensburgh-and-lomond-area-community-planning-group/item/4"
                                        }
                                    ],
                                    "meta": {
                                        "count": 2,
                                        "next_cursor": "eyJvIjoyfQ",
                                        "page": 1,
                                        "per_page": 2,
                                        "total": null,
                                        "total_pages": null,
                                        "next_page": 2,
                                        "prev_page": null
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/responses/Error"
                    },
                    "401": {
                        "$ref": "#/components/responses/Error"
                    },
                    "422": {
                        "$ref": "#/components/responses/Error"
                    },
                    "429": {
                        "$ref": "#/components/responses/Error"
                    },
                    "500": {
                        "$ref": "#/components/responses/Error"
                    }
                },
                "security": [
                    {},
                    {
                        "bearer": []
                    },
                    {
                        "apiKey": []
                    }
                ]
            }
        },
        "/papers/search": {
            "get": {
                "operationId": "papers_search",
                "summary": "Search the words inside every paper: officer reports, minutes, agendas and appendices",
                "tags": [
                    "Papers"
                ],
                "externalDocs": {
                    "url": "https://councilmonitor.co.uk/documentation/papers-search"
                },
                "parameters": [
                    {
                        "name": "q",
                        "in": "query",
                        "required": true,
                        "description": "The words, a \"phrase\", -leave out, this OR that",
                        "schema": {
                            "type": "string"
                        },
                        "example": "housing"
                    },
                    {
                        "name": "council",
                        "in": "query",
                        "required": false,
                        "description": "A council slug",
                        "schema": {
                            "type": "string"
                        },
                        "example": "adur-and-worthing"
                    },
                    {
                        "name": "type",
                        "in": "query",
                        "required": false,
                        "description": "Only one kind of paper",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "report",
                                "minutes",
                                "agenda",
                                "appendix",
                                "other"
                            ]
                        }
                    },
                    {
                        "name": "years",
                        "in": "query",
                        "required": false,
                        "description": "How far back",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "1",
                                "2",
                                "5",
                                "all"
                            ],
                            "default": "all"
                        },
                        "example": "all"
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "required": false,
                        "description": "Best match or newest first",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "best",
                                "newest"
                            ],
                            "default": "best"
                        },
                        "example": "best"
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "description": "Page number, from 1",
                        "schema": {
                            "type": "integer",
                            "default": 1
                        },
                        "example": 1
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "required": false,
                        "description": "Results per page, at most 100",
                        "schema": {
                            "type": "integer",
                            "default": 25
                        },
                        "example": 25
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "required": false,
                        "description": "The next_cursor from the previous answer; faster than page for walking far",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The records, in the envelope",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Envelope"
                                },
                                "example": {
                                    "data": [
                                        {
                                            "id": "pp_7e9b95j6",
                                            "title": "CommunitiesScotlandInvestmentProg0708ANNEX, 05/07/2007 Pre-Agenda Briefing of the Executive",
                                            "kind": "appendix",
                                            "pages": null,
                                            "text": "read",
                                            "link": "https://councilmonitor.co.uk/council/argyll-and-bute/meeting/2007-07-19-executive/papers/70042bbc3d6b/communitiesscotlandinvestmentprog0708annex-05-07-2007-pre-agenda-briefing-of-the.pdf",
                                            "official_url": "https://www.argyll-bute.gov.uk/moderngov/documents/s29688/CommunitiesScotlandInvestmentProg0708ANNEX%2005072007%20Pre-Agenda%20Briefing%20of%20the%20Executive.pdf",
                                            "council": {
                                                "slug": "argyll-and-bute",
                                                "name": "Argyll and Bute"
                                            },
                                            "committee": "Executive",
                                            "date": "2007-07-19",
                                            "meeting": "mt_ea6t00yh",
                                            "quote": "...Fyne Homes Ballochgoy, Rothesay £0.900m Provision of 24 Regeneration of Ballochgoy «Housing» Estate,\n general needs «houses» Rothesay including environmental improvements.\n for..."
                                        }
                                    ],
                                    "meta": {
                                        "count": 1,
                                        "next_cursor": "eyJvIjoxfQ",
                                        "page": 1,
                                        "per_page": 1,
                                        "total": 9770,
                                        "total_pages": 9770,
                                        "next_page": 2,
                                        "prev_page": null,
                                        "total_is_at_least": false
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/responses/Error"
                    },
                    "401": {
                        "$ref": "#/components/responses/Error"
                    },
                    "422": {
                        "$ref": "#/components/responses/Error"
                    },
                    "429": {
                        "$ref": "#/components/responses/Error"
                    },
                    "500": {
                        "$ref": "#/components/responses/Error"
                    }
                },
                "security": [
                    {},
                    {
                        "bearer": []
                    },
                    {
                        "apiKey": []
                    }
                ]
            }
        },
        "/papers/{id}": {
            "get": {
                "operationId": "paper",
                "summary": "One paper: where it belongs, its pages and its opening (the full text with a key)",
                "tags": [
                    "Papers"
                ],
                "externalDocs": {
                    "url": "https://councilmonitor.co.uk/documentation/paper"
                },
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "The id, as the other endpoints give it",
                        "schema": {
                            "type": "string"
                        },
                        "example": "pp_7e9b95j6"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The records, in the envelope",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Envelope"
                                },
                                "example": {
                                    "data": {
                                        "id": "pp_7e9b95j6",
                                        "title": "CommunitiesScotlandInvestmentProg0708ANNEX, 05/07/2007 Pre-Agenda Briefing of the Executive",
                                        "kind": "appendix",
                                        "pages": null,
                                        "text": "read",
                                        "link": "https://councilmonitor.co.uk/council/argyll-and-bute/meeting/2007-07-19-executive/papers/70042bbc3d6b/communitiesscotlandinvestmentprog0708annex-05-07-2007-pre-agenda-briefing-of-the.pdf",
                                        "official_url": "https://www.argyll-bute.gov.uk/moderngov/documents/s29688/CommunitiesScotlandInvestmentProg0708ANNEX%2005072007%20Pre-Agenda%20Briefing%20of%20the%20Executive.pdf",
                                        "council": {
                                            "slug": "argyll-and-bute",
                                            "name": "Argyll and Bute"
                                        },
                                        "committee": "Executive",
                                        "date": "2007-07-19",
                                        "meeting": "mt_ea6t00yh",
                                        "item": "it_1qwjj4p9",
                                        "characters": 13025,
                                        "opening": "ANNEX\n COMMUNITIES SCOTLAND’S INVESTMENT PROGRAMME 2007/2008\nBute & Cowal\n DEVELOPER PROJECT PLANNED NATURE OF COMMENTS\n INVESTMENT PROVISION\nArgyll & Bute Council Demolition of Spence £0.130m Demolition of Payment of Early Action Funding in support of this\n Court redundant flats...",
                                        "text_parts": 1
                                    },
                                    "meta": {
                                        "note": "The opening 1,500 of 13,025 characters. The full text is at /v1/papers/pp_7e9b95j6/text with a Pro Plus key.",
                                        "plan": "Pro Plus"
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/responses/Error"
                    },
                    "401": {
                        "$ref": "#/components/responses/Error"
                    },
                    "404": {
                        "$ref": "#/components/responses/Error"
                    },
                    "422": {
                        "$ref": "#/components/responses/Error"
                    },
                    "429": {
                        "$ref": "#/components/responses/Error"
                    },
                    "500": {
                        "$ref": "#/components/responses/Error"
                    }
                },
                "security": [
                    {},
                    {
                        "bearer": []
                    },
                    {
                        "apiKey": []
                    }
                ]
            }
        },
        "/papers/{id}/text": {
            "get": {
                "operationId": "paper_text",
                "summary": "A paper's full text, in parts of 30,000 characters",
                "tags": [
                    "Papers"
                ],
                "externalDocs": {
                    "url": "https://councilmonitor.co.uk/documentation/paper-text"
                },
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "description": "The id, as the other endpoints give it",
                        "schema": {
                            "type": "string"
                        },
                        "example": "pp_7e9b95j6"
                    },
                    {
                        "name": "part",
                        "in": "query",
                        "required": false,
                        "description": "Which part, from 1",
                        "schema": {
                            "type": "integer",
                            "default": 1
                        },
                        "example": 1
                    }
                ],
                "responses": {
                    "200": {
                        "description": "The records, in the envelope",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Envelope"
                                },
                                "example": {
                                    "data": {
                                        "id": "pp_7e9b95j6",
                                        "part": 1,
                                        "parts": 1,
                                        "characters": 13025,
                                        "text": "ANNEX\n COMMUNITIES SCOTLAND’S INVESTMENT PROGRAMME 2007/2008\nBute & Cowal\n DEVELOPER PROJECT PLANNED NATURE OF COMMENTS\n INVESTMENT PROVISION\nArgyll & Bute Council Demolition of Spence £0.130m Demolition of Payment of Early Action Funding in support of this\n Court redundant flats..."
                                    },
                                    "meta": {
                                        "next_part": null
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/responses/Error"
                    },
                    "401": {
                        "$ref": "#/components/responses/Error"
                    },
                    "403": {
                        "$ref": "#/components/responses/Error"
                    },
                    "404": {
                        "$ref": "#/components/responses/Error"
                    },
                    "422": {
                        "$ref": "#/components/responses/Error"
                    },
                    "429": {
                        "$ref": "#/components/responses/Error"
                    },
                    "500": {
                        "$ref": "#/components/responses/Error"
                    }
                },
                "security": [
                    {
                        "bearer": []
                    },
                    {
                        "apiKey": []
                    }
                ]
            }
        },
        "/usage": {
            "get": {
                "operationId": "usage",
                "summary": "What this key or address has used, its limits and when they reset (not counted)",
                "tags": [
                    "Your key"
                ],
                "externalDocs": {
                    "url": "https://councilmonitor.co.uk/documentation/usage"
                },
                "parameters": [],
                "responses": {
                    "200": {
                        "description": "The records, in the envelope",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Envelope"
                                },
                                "example": {
                                    "data": {
                                        "plan": "No key",
                                        "key": null,
                                        "limit": 60,
                                        "period": "hour",
                                        "used": 3,
                                        "remaining": 57,
                                        "resets": "2026-11-17T12:00:00Z",
                                        "full_text": false
                                    },
                                    "meta": {}
                                }
                            }
                        }
                    },
                    "400": {
                        "$ref": "#/components/responses/Error"
                    },
                    "401": {
                        "$ref": "#/components/responses/Error"
                    },
                    "422": {
                        "$ref": "#/components/responses/Error"
                    },
                    "500": {
                        "$ref": "#/components/responses/Error"
                    }
                },
                "security": [
                    {},
                    {
                        "bearer": []
                    },
                    {
                        "apiKey": []
                    }
                ]
            }
        }
    },
    "components": {
        "securitySchemes": {
            "bearer": {
                "type": "http",
                "scheme": "bearer",
                "description": "A Pro Plus key, cmk_..."
            },
            "apiKey": {
                "type": "apiKey",
                "in": "header",
                "name": "X-API-Key"
            }
        },
        "schemas": {
            "Envelope": {
                "type": "object",
                "required": [
                    "data",
                    "meta"
                ],
                "properties": {
                    "data": {
                        "description": "One record or a list of records"
                    },
                    "meta": {
                        "type": "object"
                    }
                }
            },
            "Error": {
                "type": "object",
                "required": [
                    "error"
                ],
                "properties": {
                    "error": {
                        "type": "object",
                        "required": [
                            "code",
                            "message"
                        ],
                        "properties": {
                            "code": {
                                "type": "string",
                                "enum": [
                                    "bad_request",
                                    "unauthorized",
                                    "upgrade_required",
                                    "not_found",
                                    "unknown_parameter",
                                    "rate_limited",
                                    "quota_exceeded",
                                    "server_error"
                                ]
                            },
                            "message": {
                                "type": "string"
                            },
                            "plan": {
                                "type": "string"
                            },
                            "docs": {
                                "type": "string",
                                "format": "uri"
                            }
                        }
                    }
                }
            }
        },
        "responses": {
            "Error": {
                "description": "An error, its code fixed for good",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/Error"
                        }
                    }
                }
            }
        }
    }
}
