{
  "openapi": "3.0.3",
  "info": {
    "title": "GOTHAM Signals — Free Public Sample",
    "version": "0.20.14.16",
    "description": "A bounded, source-linked Manhattan signal sample. This API is not a paid interface and does not expose customer or contact data."
  },
  "servers": [
    {
      "url": "https://gothamsignals.com"
    }
  ],
  "paths": {
    "/api/agent/manifest.php": {
      "get": {
        "summary": "Discover available machine-readable capabilities",
        "responses": {
          "200": {
            "description": "Public discovery metadata"
          }
        }
      }
    },
    "/api/agent/signals.php": {
      "get": {
        "summary": "Retrieve three or fewer public-source-linked Manhattan signals",
        "parameters": [
          {
            "name": "days",
            "in": "query",
            "schema": {
              "type": "integer",
              "enum": [
                7,
                30
              ],
              "default": 7
            },
            "description": "Source-event date window"
          }
        ],
        "responses": {
          "200": {
            "description": "Bounded sample",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean"
                    },
                    "sample_only": {
                      "type": "boolean"
                    },
                    "paid_access": {
                      "type": "boolean"
                    },
                    "generated_at": {
                      "type": "string"
                    },
                    "requested_window_days": {
                      "type": "integer"
                    },
                    "watcher": {
                      "type": "object"
                    },
                    "count": {
                      "type": "integer"
                    },
                    "results": {
                      "type": "array",
                      "maxItems": 3,
                      "items": {
                        "type": "object",
                        "properties": {
                          "signal_id": {
                            "type": "string"
                          },
                          "category": {
                            "type": "string"
                          },
                          "screening_score": {
                            "type": "integer"
                          },
                          "address": {
                            "type": "string"
                          },
                          "source_name": {
                            "type": "string"
                          },
                          "source_url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "source_event_at": {
                            "type": "string"
                          },
                          "indexed_at": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "caveat": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid window"
          },
          "503": {
            "description": "Sample unavailable"
          }
        }
      }
    }
  }
}