Response Objects

The concise GeoJSON response returned by the Stream API.

StreamResponse

The object below is a captured response snapshot from the livepotholes in New York stream request used in the Quickstart. It is stored with the docs so this page remains stable; media URLs are redacted and the page does not make a live request.

JSON

{
  "isSuccess": true,
  "result_id": "ac4adb36-4a58-4589-a8f9-f3789a0d0946",
  "data": {
    "query": "potholes in New York",
    "duration_ms": 1183,
    "geojson": {
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "id": "1928656524330738",
          "geometry": {
            "type": "Point",
            "coordinates": [
              -73.959623,
              40.801995
            ]
          },
          "properties": {
            "id": "1928656524330738",
            "address": "256 MANHATTAN AVE, New York, NY, 10026, United States",
            "duration": 0,
            "is_video": false,
            "month": "2",
            "owner": "iragersh",
            "video_id": "3HnfqDwu7WQBM29FRrhyg0",
            "source": "mapillary",
            "video_url": "<video URL>",
            "year": "2025",
            "feature_name": "Pothole",
            "image_url": "<image URL>",
            "interactive": false,
            "date": "2025-02-08 17:11:24+00"
          }
        },
        {
          "type": "Feature",
          "id": "2338893119587774",
          "geometry": {
            "type": "Point",
            "coordinates": [
              -73.874708333333,
              40.887703333333
            ]
          },
          "properties": {
            "id": "2338893119587774",
            "address": "New York City, New York, United States",
            "month": "9",
            "source": "mapillary",
            "year": "2016",
            "feature_name": "Pothole",
            "image_url": "<image URL>",
            "interactive": false,
            "date": "2016-09-06 12:32:00.649+00"
          }
        },
        {
          "type": "Feature",
          "id": "755424196947069",
          "geometry": {
            "type": "Point",
            "coordinates": [
              -73.893147,
              40.814596
            ]
          },
          "properties": {
            "id": "755424196947069",
            "address": "1129 LONGWOOD AVE, New York, NY, 10474, United States",
            "month": "7",
            "owner": "iragersh",
            "source": "mapillary",
            "year": "2025",
            "feature_name": "Pothole",
            "image_url": "<image URL>",
            "interactive": false,
            "date": "2025-07-30 18:46:50+00"
          }
        },
        {
          "type": "Feature",
          "id": "299783558272838",
          "geometry": {
            "type": "Point",
            "coordinates": [
              -73.658178910979,
              40.663072744807
            ]
          },
          "properties": {
            "id": "299783558272838",
            "address": "125 Ocean Avenue, Unit 27, Lynbrook, NY, 11563, United States",
            "duration": 28,
            "is_video": false,
            "month": "4",
            "owner": "daalso",
            "video_id": "a8AJT7L-S8aCV7HTK1LhCw",
            "source": "mapillary",
            "video_url": "<video URL>",
            "year": "2019",
            "feature_name": "Pothole",
            "image_url": "<image URL>",
            "interactive": false,
            "date": "2019-04-30 15:33:10.731+00"
          }
        },
        {
          "type": "Feature",
          "id": "2631119517192915",
          "geometry": {
            "type": "Point",
            "coordinates": [
              -74.682877873889,
              44.828358571944
            ]
          },
          "properties": {
            "id": "2631119517192915",
            "address": "1461 County Route 55, Brasher Falls, Brasher, NY, 13613, United States",
            "duration": 152,
            "is_video": false,
            "month": "5",
            "owner": "hshearer",
            "video_id": "mx0p6dvu0vcammy8h8lryr",
            "source": "mapillary",
            "video_url": "<video URL>",
            "year": "2019",
            "feature_name": "Pothole",
            "image_url": "<image URL>",
            "interactive": false,
            "date": "2019-05-30 09:09:47+00"
          }
        }
      ]
    },
    "regions": [
      {
        "id": "4915",
        "name": "New York",
        "layer": "state",
        "state_name": "New York",
        "country_name": "United States"
      }
    ],
    "year": null
  }
}

Field	Type	Description
`isSuccess`	boolean	Whether the search completed successfully.
`result_id`	string	Identifier for the stored search and shareable result.
`regions`	array	Region scope used for the search.
`data.geojson`	FeatureCollection	The matching results as standard GeoJSON.

Objects

Object	Description
`StreamResponse`	The full response envelope: status, result_id, and data.
`Feature`	One matching real-world observation as a GeoJSON feature.
`Geometry`	A GeoJSON geometry, commonly a Point in [lng, lat] coordinates.
`Media`	Public thumbnail, video, and visual URLs when available.
`InteractiveFeature`	A feature with interactive: true and a 360° video_url.

See Stream Results for the feature field reference, and Errors for failure shapes.