{"files":{"SKILL.md":"---\nname: v1\ndescription: \"v1 API skill. Use when working with v1 for v{version}. Covers 10 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# v1\nAPI version: v1\n\n## Auth\nNo authentication required.\n\n## Base URL\nhttps://webtris.highwaysengland.co.uk/api\n\n## Setup\n1. No auth setup needed\n2. GET /v{version}/areas -- returns list of areas\n3. Explore available endpoints below\n\n## Endpoints\n10 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### V{version}\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /v{version}/areas | Returns list of areas |\n| GET | /v{version}/areas/{area_Ids} | Returns details of selected area |\n| GET | /v{version}/quality/overall | Get Site OverallQuality |\n| GET | /v{version}/quality/daily | Get Site DailyQuality |\n| GET | /v{version}/reports/{report_type} | Gets the daily report. |\n| GET | /v{version}/reports/{start_date}/to/{end_date}/{report_type} | Gets the daily report. |\n| GET | /v{version}/sites | Get a list of sites |\n| GET | /v{version}/sites/{site_Ids} | Get selected sites |\n| GET | /v{version}/sitetypes | Return list of site types |\n| GET | /v{version}/sitetypes/{siteType_Id}/sites | Returns the layer metadata for the LayerId specified. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all areas?\" -> GET /v{version}/areas\n- \"Get area details?\" -> GET /v{version}/areas/{area_Ids}\n- \"List all overall?\" -> GET /v{version}/quality/overall\n- \"List all daily?\" -> GET /v{version}/quality/daily\n- \"Get report details?\" -> GET /v{version}/reports/{report_type}\n- \"Get to details?\" -> GET /v{version}/reports/{start_date}/to/{end_date}/{report_type}\n- \"List all sites?\" -> GET /v{version}/sites\n- \"Get site details?\" -> GET /v{version}/sites/{site_Ids}\n- \"List all sitetypes?\" -> GET /v{version}/sitetypes\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Paginated endpoints accept limit/offset or cursor parameters\n- Error responses include status codes and descriptions in the spec\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api v1\n@base https://webtris.highwaysengland.co.uk/api\n@version v1\n@common_fields {version: any}\n@endpoints 10\n@toc v{version}(10)\n\n@endpoint GET /v{version}/areas\n@desc Returns list of areas\n@returns(200)\n@errors {400: Bad request, 500: Internal Server Error}\n\n@endpoint GET /v{version}/areas/{area_Ids}\n@desc Returns details of selected area\n@required {area_Ids: any}\n@returns(200)\n@errors {400: Bad request, 500: Internal Server Error}\n\n@endpoint GET /v{version}/quality/overall\n@desc Get Site OverallQuality\n@required {sites: any # Get site quality by site id delimited by ,, start_date: any # The start date of the report in the format ddmmyyyy (i.e 31012016), end_date: any # The end date of the report in the format ddmmyyyy (i.e 31012016)}\n@returns(200)\n@errors {400: Bad request, 500: Internal Server Error}\n\n@endpoint GET /v{version}/quality/daily\n@desc Get Site DailyQuality\n@required {siteId: any, start_date: any # The start date of the report in the format ddmmyyyy (i.e 31012016), end_date: any # The end date of the report in the format ddmmyyyy (i.e 31012016)}\n@returns(200)\n@errors {400: Bad request, 500: Internal Server Error}\n\n@endpoint GET /v{version}/reports/{report_type}\n@desc Gets the daily report.\n@required {report_type: any # Report Type Id (i.e Daily, Monthly, Annual), sites: any # Comma separated list of site Ids., start_date: any # The start date of the report in the format ddmmyyyy (i.e 31012016), end_date: any # The end date of the report in the format ddmmyyyy (i.e 31012016), page: any # The page offset to return., page_size: any # The number of rows to return.}\n@optional {reportSubTypeId: any}\n@returns(200)\n@errors {400: Bad request, 500: Internal Server Error}\n\n@endpoint GET /v{version}/reports/{start_date}/to/{end_date}/{report_type}\n@desc Gets the daily report.\n@required {report_type: any # Report Type Id (i.e Daily, Monthly, Annual), sites: any # Comma separated list of site Ids., start_date: any # The start date of the report in the format ddmmyyyy (i.e 31012016), end_date: any # The end date of the report in the format ddmmyyyy (i.e 31012016), page: any # The page offset to return., page_size: any # The number of rows to return.}\n@optional {reportSubTypeId: any}\n@returns(200)\n@errors {400: Bad request, 500: Internal Server Error}\n\n@endpoint GET /v{version}/sites\n@desc Get a list of sites\n@returns(200)\n@errors {400: Bad request, 500: Internal Server Error}\n\n@endpoint GET /v{version}/sites/{site_Ids}\n@desc Get selected sites\n@required {site_Ids: any # site id}\n@returns(200)\n@errors {400: Bad request, 500: Internal Server Error}\n\n@endpoint GET /v{version}/sitetypes\n@desc Return list of site types\n@returns(200)\n@errors {400: Bad request, 500: Internal Server Error}\n\n@endpoint GET /v{version}/sitetypes/{siteType_Id}/sites\n@desc Returns the layer metadata for the LayerId specified.\n@required {siteType_Id: any # 1 = MIDAS, 2 = TAME, 3 = TMU, 4 = TRADS Legacy}\n@returns(200)\n@errors {400: Bad request, 404: Layer not found, 500: Internal Server Error}\n\n@end\n"}}