Listing Issues

Use this query to list multiple issues.

General
URL Format http://[locale].seeclickfix.com/[api|devapi]issues.[format]
Example http://seeclickfix.com/api/issues.xml?at=New+Haven,+CT
HTTP Method GET
Valid Data Formats xml, json, kml, rss (geoRSS)
Permissions read only. API key not required.

Required Parameters

Area in the form of one area type below.

Parameter Format Description
watcher_token Random string given after creating a watch area. All area within the associated polygon.
at, zoom
  • at - geocodable street address. e.g. zipcode, city, state or 123 state st. new haven, ct.
  • zoom - integer level from 0 – 19 based on google maps.
Area will be the bounding box of a 650px X 650px map at the zoom level given surrounding the geocoded location. If no zoom is give, zoom will be determined from geocoding accuracy (i.e. street, city, or country level).
lat, lng, and zoom
  • lat - Lattitude
  • lng - Longitude
  • zoom - zoom level from 0 – 19
Area will be the bounding box of a 650px X 650px google map at the zoom level given surrounding the lat/lng location given.
lat_min, lat_max, lng_min, lng_max
  • lat_min - minimum latitude
  • lng_min - minimum longitude
  • lat_max - maximum latitude
  • lng_max - maximum longitude
Limit issues to bounding box defined by lat min/max and lng min/max.

Optional Parameters

  • status[Open] - Set equal to "true" to see open issues. If status is not set the API returns Open, Closed, and Acknowledged issues.
  • status[Closed] - Set equal to "true" to see closed issues. If status is not set the API returns Open, Closed, and Acknowledged issues.
  • status[Acknowledged] - Set equal to "true" to see acknowledged issues. If status is not set the API returns Open, Closed, and Acknowledged issues.
  • status[Archived] - Set equal to "true" to see archived issues. If status is not set the API returns Open, Closed, and Acknowledged issues.
  • start – The number of hours ago the oldest issue can be. Partial hours can be in decimal format, for example 0.25 shows reports in the last 15min.
  • end – The number of hours ago the youngest issue can be.
  • num_results - The maximum number of results to return (default 10, maximum 1000).
  • page – If the number of results exceeds num_results, page can increment the range.
  • search – A query string to limit the results by.
  • sort – A parameter to sort the results by. Possible values include: issues.updated_at - Date last updated
    Issues.created_at - Date Created
    Issues.rating - Issue Rating
    Issues.hot - Issue Hotness
  • direction – Sort direction. Possible values include: ASC - Ascending
    DESC - Descending.
  • request_tags – Limit results to issues with service request tags. Service request tags are automatically added to issues when issues are reported to a specific service request. Multiple request tags can be found using the form "request_type_[request_type_id],request_type_[request_type_id],request_type_[request_type_id]".

Example:

http://seeclickfix.com/api/issues.json?at=New+Haven,+CT&zoom=10&start=24&end=0&page=1&num_results=5&sort=issues.created_at

This query says show me all issues within “New Haven, CT” from a zoom level of 10. Limit the results by issues updated in the last 24 hours and only the last 5 created.

Pagination

Data is returned in chunks of num_results. You can increment the page parameter to get the next group of results. If page exceeds the total number of pages the result will be an empty array. For example, say you want 10,000 results of graffiti. You can make 10 requests with page from 1 to 10 and num_results = 1000.

Data License

SeeClickFix data sources, including XML, RSS, KML and JSON, are licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 United States License. Attribution should be to seeclickfix.com.

Persons or organizations wishing to reuse large portions (ie., more than occasional queries ) of data are required to contact us first at team@seeclickfix.com. We are very interested in working with researchers and/or agencies to ensure that this data is put to good use!

http://www.seeclickfix.com/open_data