API Documentation

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/barking-dagenham/planning?postcode=IG11&status=approved"

{
  "status": "success",
  "data": [{
    "reference": "23/01234/FUL",
    "address": "42 Longbridge Rd, Barking IG11 8SF",
    "description": "Single storey rear extension",
    "status": "approved",
    "decision_date": "2025-11-14"
  }],
  "meta": { "total": 87, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/bristol/services?type=library"

{
  "status": "success",
  "data": [{
    "name": "Bristol Central Library",
    "type": "library",
    "address": "College Green, Bristol BS1 5TL",
    "lat": 51.4531,
    "lng": -2.5990,
    "open_hours": "Mon-Sat 09:00-17:00"
  }],
  "meta": { "total": 27, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/companies-house/companies?name=Acme&status=active"

{
  "status": "success",
  "data": [{
    "company_number": "12345678",
    "company_name": "ACME INNOVATIONS LTD",
    "status": "active",
    "type": "ltd",
    "incorporated": "2019-03-15",
    "address": "10 Downing Street, London SW1A 2AA",
    "sic_codes": ["62012"]
  }],
  "meta": { "total": 1842, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/ico/registrations?organisation=Acme"

{
  "status": "success",
  "data": [{
    "registration_number": "ZA123456",
    "organisation": "Acme Innovations Ltd",
    "status": "current",
    "start_date": "2024-06-01",
    "expiry_date": "2025-05-31",
    "tier": "1"
  }],
  "meta": { "total": 3, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/natural-resources-wales/permits?type=water"

{
  "status": "success",
  "data": [{
    "permit_id": "NRW-WP-004521",
    "holder": "Welsh Water",
    "type": "water",
    "location": "Cardiff Bay, CF10",
    "status": "active",
    "issued": "2023-01-10"
  }],
  "meta": { "total": 215, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/valuation-office/council-tax?postcode=SW1A+2AA"

{
  "status": "success",
  "data": [{
    "address": "10 Downing Street, London SW1A 2AA",
    "band": "H",
    "local_authority": "City of Westminster",
    "effective_date": "1993-04-01"
  }],
  "meta": { "total": 1, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/cabinet-office/contracts?value_min=100000"

{
  "status": "success",
  "data": [{
    "contract_id": "CO-2025-08432",
    "title": "Cloud Infrastructure Services",
    "supplier": "UK Cloud Solutions Ltd",
    "value": 450000,
    "currency": "GBP",
    "awarded_date": "2025-09-20",
    "department": "Cabinet Office"
  }],
  "meta": { "total": 312, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/cqc/providers?type=care_home&rating=outstanding"

{
  "status": "success",
  "data": [{
    "provider_id": "1-2345678901",
    "name": "Sunrise Care Home",
    "type": "care_home",
    "rating": "outstanding",
    "address": "14 Oak Lane, Surrey GU1 3AA",
    "last_inspection": "2025-08-12"
  }],
  "meta": { "total": 48, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/glaa/licences?sector=agriculture&status=active"

{
  "status": "success",
  "data": [{
    "licence_number": "GLAA-0045-2024",
    "holder": "Harvest Staffing Ltd",
    "sector": "agriculture",
    "status": "active",
    "issued": "2024-04-01",
    "expiry": "2026-03-31"
  }],
  "meta": { "total": 134, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/insolvency/cases?type=bankruptcy&date_from=2025-01-01"

{
  "status": "success",
  "data": [{
    "case_number": "INS-2025-00842",
    "type": "bankruptcy",
    "name": "J. Smith",
    "court": "High Court of Justice",
    "date": "2025-03-14",
    "status": "active"
  }],
  "meta": { "total": 2041, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/ordnance-survey/postcodes/SW1A+2AA"

{
  "status": "success",
  "data": {
    "postcode": "SW1A 2AA",
    "lat": 51.50354,
    "lng": -0.12768,
    "admin_district": "Westminster",
    "country": "England",
    "region": "London",
    "parliamentary_constituency": "Cities of London and Westminster"
  }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/nhs/organisations?type=gp&postcode=E1"

{
  "status": "success",
  "data": [{
    "ods_code": "F84001",
    "name": "The Whitechapel Practice",
    "type": "gp",
    "address": "30 Brady Street, London E1 5DJ",
    "phone": "020 7247 1234",
    "accepting_patients": true
  }],
  "meta": { "total": 23, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/phe/indicators?indicator_id=90366&area_code=E92000001"

{
  "status": "success",
  "data": [{
    "indicator_id": 90366,
    "indicator_name": "Life expectancy at birth",
    "area_code": "E92000001",
    "area_name": "England",
    "value": 81.3,
    "unit": "years",
    "year": 2024
  }],
  "meta": { "total": 1, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/cherwell/planning?postcode=OX16"

{
  "status": "success",
  "data": [{
    "reference": "25/00345/FUL",
    "address": "7 Castle Street, Banbury OX16 5NU",
    "description": "Change of use from office to residential",
    "status": "pending",
    "submitted": "2025-10-11"
  }],
  "meta": { "total": 62, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/dclg/housing?metric=completions&year=2025"

{
  "status": "success",
  "data": [{
    "local_authority": "Manchester",
    "metric": "completions",
    "value": 3420,
    "year": 2025,
    "tenure": "all"
  }],
  "meta": { "total": 356, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/hse/incidents?severity=major&industry=construction"

{
  "status": "success",
  "data": [{
    "reference": "HSE-INC-2025-04230",
    "industry": "construction",
    "severity": "major",
    "description": "Fall from height at building site",
    "region": "North West",
    "date": "2025-07-03"
  }],
  "meta": { "total": 189, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/leeds/planning?ward=Headingley"

{
  "status": "success",
  "data": [{
    "reference": "25/03021/FUL",
    "address": "16 Headingley Lane, Leeds LS6 1BL",
    "description": "Loft conversion with rear dormer",
    "status": "approved",
    "ward": "Headingley & Hyde Park"
  }],
  "meta": { "total": 41, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/lps/valuations?postcode=BT1+1AA"

{
  "status": "success",
  "data": [{
    "address": "1 Donegall Square North, Belfast BT1 1AA",
    "capital_value": 285000,
    "type": "domestic",
    "valuation_date": "2005-01-01"
  }],
  "meta": { "total": 12, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/royal-mail/addresses?postcode=EC2R+8AH"

{
  "status": "success",
  "data": [{
    "udprn": "12345678",
    "address_line_1": "Bank of England",
    "address_line_2": "Threadneedle Street",
    "post_town": "London",
    "postcode": "EC2R 8AH",
    "delivery_point_type": "large_user"
  }],
  "meta": { "total": 5, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/dover/planning?status=approved"

{
  "status": "success",
  "data": [{
    "reference": "25/00189/FUL",
    "address": "8 Marine Parade, Dover CT17 9BQ",
    "description": "Conversion of upper floors to flats",
    "status": "approved",
    "decision_date": "2025-12-10"
  }],
  "meta": { "total": 93, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/company-names-tribunal/decisions?outcome=upheld"

{
  "status": "success",
  "data": [{
    "case_number": "CNA/2025/0034",
    "respondent_company": "Brand Lookalike Ltd",
    "applicant": "Original Brand Holdings Plc",
    "outcome": "upheld",
    "decision_date": "2025-06-22"
  }],
  "meta": { "total": 28, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/gambling-commission/licences?type=remote&status=active"

{
  "status": "success",
  "data": [{
    "account_number": "54321",
    "operator": "SafeBet Online Ltd",
    "type": "remote",
    "activity": "casino",
    "status": "active",
    "licence_start": "2022-08-01"
  }],
  "meta": { "total": 847, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/hmrc/vat?vat_number=GB123456789"

{
  "status": "success",
  "data": {
    "vat_number": "GB123456789",
    "name": "Acme Innovations Ltd",
    "address": "10 Downing Street, London SW1A 2AA",
    "valid": true,
    "registered_date": "2019-06-01"
  }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/hseni/incidents?county=Antrim"

{
  "status": "success",
  "data": [{
    "reference": "HSENI-2025-00312",
    "industry": "manufacturing",
    "severity": "major",
    "county": "Antrim",
    "description": "Worker injured by machinery",
    "date": "2025-05-18"
  }],
  "meta": { "total": 42, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/fsa/hygiene-ratings?postcode=W1D&rating=5"

{
  "status": "success",
  "data": [{
    "fhrs_id": 987654,
    "business_name": "The Golden Fork",
    "type": "restaurant",
    "rating": 5,
    "address": "22 Dean Street, London W1D 3RY",
    "inspection_date": "2025-09-05"
  }],
  "meta": { "total": 142, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/land-registry/price-paid?postcode=SW1A+2AA&date_from=2024-01-01"

{
  "status": "success",
  "data": [{
    "transaction_id": "A1B2C3D4E5F6",
    "price": 1250000,
    "date": "2024-06-15",
    "address": "Flat 3, 12 Downing Street, London SW1A 2AA",
    "property_type": "flat",
    "new_build": false,
    "tenure": "leasehold"
  }],
  "meta": { "total": 4, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/hull/planning?postcode=HU1"

{
  "status": "success",
  "data": [{
    "reference": "25/00712/FUL",
    "address": "15 Queen Victoria Square, Hull HU1 3RQ",
    "description": "Shop front alteration",
    "status": "approved",
    "decision_date": "2025-11-28"
  }],
  "meta": { "total": 35, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/met-police/crimes?category=burglary&postcode=E1+6AN&date=2025-10"

{
  "status": "success",
  "data": [{
    "crime_id": "a8b2c3d4e5",
    "category": "burglary",
    "location": "On or near Commercial Road",
    "lat": 51.5145,
    "lng": -0.0652,
    "date": "2025-10",
    "outcome": "under_investigation"
  }],
  "meta": { "total": 18, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/ons/population?area_code=E92000001&year=2025"

{
  "status": "success",
  "data": [{
    "area_code": "E92000001",
    "area_name": "England",
    "year": 2025,
    "population": 57106400,
    "male": 28215000,
    "female": 28891400
  }],
  "meta": { "total": 1, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/sepa/licences?type=waste&local_authority=Glasgow"

{
  "status": "success",
  "data": [{
    "licence_id": "SEPA-WML-0084",
    "holder": "Glasgow Recycling Services",
    "type": "waste",
    "status": "active",
    "local_authority": "Glasgow City",
    "issued": "2021-03-20"
  }],
  "meta": { "total": 67, "page": 1, "per_page": 25 }
}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.insightpipe.co.uk/v1/dwp/benefits?benefit=universal_credit&area_code=E92000001&quarter=2025-Q4"

{
  "status": "success",
  "data": [{
    "benefit": "universal_credit",
    "area_code": "E92000001",
    "area_name": "England",
    "quarter": "2025-Q4",
    "claimants": 5420000,
    "in_employment": 2140000,
    "searching_for_work": 1860000
  }],
  "meta": { "total": 1, "page": 1, "per_page": 25 }
}