Bills API

```json
{
  "service_type": "platform",
  "base_url": "https://bills-api.parliament.uk",
  "auth_method": "none",
  "auth_config": {},
  "endpoints": [
    {
      "path": "/api/v1/Bills",
      "method": "GET",
      "description": "Search and retrieve a list of Bills. Supports filtering by search term, session, member, bill stage, and pagination (skip/take)."
    },
    {
      "path": "/api/v1/Bills/{billId}",
      "method": "GET",
      "description": "Retrieve details for a specific Bill by ID."
    },
    {
      "path": "/api/v1/Bills/{billId}/Stages",
      "method": "GET",
      "description": "List the stages a Bill has passed through, with dates and outcomes."
    },
    {
      "path": "/api/v1/Bills/{billId}/Stages/{billStageId}",
      "method": "GET",
      "description": "Retrieve details of a specific Bill stage."
    },
    {
      "path": "/api/v1/Bills/{billId}/Publications",
      "method": "GET",
      "description": "List publications (e.g. texts, explanatory notes) associated with a Bill."
    },
    {
      "path": "/api/v1/Bills/{billId}/Sponsors",
      "method": "GET",
      "description": "List sponsors of a Bill."
    },
    {
      "path": "/api/v1/BillTypes",
      "method": "GET",
      "description": "List bill types (Government, Private Members', Hybrid, etc.)."
    },
    {
      "path": "/api/v1/Sessions",
      "method": "GET",
      "description": "Retrieve UK parliamentary sessions for filtering."
    },
    {
      "path": "/api/v1/Stages",
      "method": "GET",
      "description": "List the types of stages a Bill can pass through."
    }
  ],
  "pricing_model": {
    "type": "free",
    "details": {
      "note": "Public government API, no cost, no registration required for basic access.",
      "provider": "UK Parliament"
    }
  },
  "rate_limits": {
    "note": "No published rate limits; standard fair-use applies."
  },
  "capabilities": [
    "Search and filter UK parliamentary Bills (Commons and Lords)",
    "Retrieve detailed information on individual Bills by ID",
    "Track Bill stages, dates, and outcomes",
    "Access Bill publications (texts, explanatory notes, amendments)",
    "Identify Bill sponsors and members involved",
    "Enumerate Bill types and parliamentary sessions",
    "OpenAPI/Swagger documentation available for self-describing integration"
  ],
  "raw_analysis": "The Bills API is a public UK Parliament service exposing structured information about Bills progressing through the UK Parliament (House of Commons and House of Lords). Contrary to the parent URL listed (www.parliament.uk), the actual API endpoint is hosted at bills-api.parliament.uk and documented via a Swagger UI at https://bills-api.parliament.uk/index.html. The API is entirely read-only, unauthenticated for typical use, and returns JSON. It is aimed at researchers, journalists, civic-tech developers, and parliamentary monitoring services that need programmatic access to legislative data — bill metadata, stages, amendments, sponsors, and publications. Maturity is high in the sense that it is an official government service backed by Parliament's data infrastructure, but it is a niche dataset (Bills only) rather than a broad 'platform' with user accounts, dashboards, or SDKs. Authentication is not required; there is no published API key system, and no listed quotas, though courteous use is expected. Pricing is free as it is publicly funded. The natural sibling services — Members API, Committees API, Hansard API, and Written Questions API — sit alongside it in Parliament's developer ecosystem. Integrations are limited to HTTP/JSON consumers; there is no native SDK, no webhooks, and no write capabilities. Overall it is a well-maintained but narrowly scoped open data API, not a multi-tenant collaboration platform."
}
```

1/3 tests passed

{
  "overall": 72,
  "dimensions": {
    "token_efficiency": 8.0,
    "first_try_success": 7.0,
    "response_parseability": 9.0,
    "error_clarity": 6.0,
    "doc_quality": 7.0,
    "auth_simplicity": 10.0,
    "latency": 9.0,
    "consistency": 7.0
  },
  "pricing_normalized": {
    "model": "free",
    "cost": "$0",
    "notes": "Public UK government API, no registration required for basic access. Maximum agent-value-for-cost."
  },
  "issues": [
    "No robots.txt (404) — search indexers and agents have no crawling guidance.",
    "No llms.txt (404) — no machine-readable agent guidance even though a Swagger/OpenAPI doc exists.",
    "Root returns a JS-driven Swagger UI bundle rather than directly serving OpenAPI JSON — the API spec is discoverable but not at the canonical machine-readable endpoint by default.",
    "Error/rate-limit documentation for the API is not surfaced in the check previews; agents may hit silent throttling or unhelpful error messages.",
    "Lords/Commons bill schemas may vary; without explicit versioning notes, first-call success on some endpoints is uncertain."
  ],
  "recommendations": [
    "Publish an llms.txt pointing agents directly to the OpenAPI spec and core endpoints (e.g., /bill, /bill/{id}, /billtype, /session).",
    "Serve the OpenAPI JSON at a stable, non-JS URL (e.g., /openapi.json) so agents can fetch and self-describe without parsing the Swagger UI bundle.",
    "Add a robots.txt with explicit Allow directives for agent crawlers.",
    "Document rate limits, error codes, and pagination behavior clearly so agents handle failures on the first try.",
    "Expose a lightweight /health or /status endpoint to support agent-side consistency checks."
  ]
}