Ensure TIPLOC is an optional entry. 'stations' will not include a TIPLOC as there is no 1-to-1 mapping.

schemas/api/envelope.json

@@ -11,11 +11,7 @@
             "description": "Unix timestamp showing when the data was generated, or the time the error was encountered"
         },
         "d": {
-            "description": "Payload data.  Type depends on request endpoint",
-            "anyOf": [
-                {"type": "object"},
-                {"type": "array"}
-            ]
+            "description": "Payload data.  Type depends on request endpoint"
         },
         "e": {
             "type": "object",

schemas/api/location-filter.json

@@ -0,0 +1,31 @@
+{
+    "$id": "https://schema.owlboard.info/api/location-filter.schema.json",
+    "$schema": "https://json-schema.org/draft-07/schema#",
+    "title": "LocationFilterObject",
+    "description": "Location filter API Response.  Provides a location's data for filtering on the frontend",
+    "type": "object",
+    "required": ["n", "s"],
+    "additionalProperties": false,
+    "properties": {
+        "n": {
+            "type": "string",
+            "name": "Name",
+            "description": "Name of the location"
+        },
+        "t": {
+            "type": "string",
+            "name": "TIPLOC",
+            "description": "TIPLOC of the location"
+        },
+        "c": {
+            "type": "string",
+            "name": "CRS",
+            "description": "CRS of the location"
+        },
+        "s": {
+            "type": "string",
+            "name": "searchString",
+            "description": "Generated string for efficient filtering"
+        }
+    }
+}

schemas/api/pis-object.json

@@ -35,6 +35,20 @@
                 "pattern": "^[a-zA-Z0-9]+$"
             },
             "description": "List of TIPLOC Codes"
+        },
+        "skip": {
+            "type": "object",
+            "properties": {
+                "skip": {
+                    "type": "integer",
+                    "description": "Number of stops to skip"
+                },
+                "position": {
+                    "type": "string",
+                    "enum": ["head", "tail"],
+                    "description": "Position of stops to be skipped, either 'head' or 'tail'"
+                }
+            }
         }
     },
     "required": ["code"],