SeeClickFix
App · 12 actions
Follow and handle SeeClickFix issues (resident reports such as potholes and graffiti): list issues in a place, read them with their comments, find request types and places, report issues, comment, acknowledge or close them, and run when an issue is reported, changes status or gets a comment.
Actions
| Action | What it does |
|---|---|
| Change issue status | Acknowledge, close or reopen an issue, with the comment SeeClickFix requires. |
| Comment on issue | Post a public comment on an issue as the connected account, optionally with a YouTube link. |
| Get connected account | Get the SeeClickFix account the connection's token belongs to, including whether it may acknowledge issues. |
| Get issue | Get one issue with its comments, the answers to its questions, who it is assigned to and its votes. |
| Get place | Get one place by its id. |
| Get request type questions | Get the questions a request type asks when an issue is reported, with the answers each allows. |
| Get user | Get a SeeClickFix user's public profile: name, role and how many issues and comments they have posted. |
| List issue comments | List every comment on an issue, oldest first. |
| List issues | List reported issues in a place or around a point, by status, request type, words, and when they were reported or updated. |
| List places | List the places (cities, counties, neighborhoods) around a point, closest first, with the URL name that lists their issues. |
| List request types at a point | List the kinds of issue that can be reported at a point, and the organization that handles each. |
| Report issue | Report a new issue at a point, as the connected account, with its request type, title, description and answers to the type's questions. |
Change issue status
Acknowledge, close or reopen an issue, with the comment SeeClickFix requires. Anyone may close or reopen an issue; only the organization's staff may acknowledge one. Needs a token.
Inputs
- Issue ID
issue_idtextRequired - The issue's number, from 'List issues', an earlier step or its page address (seeclickfix.com/issues/23137041).
- Change to
statustextRequired - Acknowledge, close or reopen the issue.One of:
acknowledged(Acknowledge),closed(Close),open(Reopen). - Comment
commenttextRequired - Why, posted on the issue with the change.
Outputs
commentobject- The comment posted
issue_statustext- The issue's status now
moderatedtrue/false- True when SeeClickFix holds it for moderation first
Example output
{
"comment": {
"comment": "Fixed.",
"comment_id": "",
"commenter_id": 1354851,
"commenter_name": "City of New Haven",
"commenter_role": "Verified Official",
"created_at": "2026-10-30T11:05:21-04:00",
"image_url": "",
"issue_id": 23137041,
"updated_at": "2026-10-30T11:05:21-04:00",
"video_url": ""
},
"issue_status": "Closed",
"moderated": false
}Comment on issue
Post a public comment on an issue as the connected account, optionally with a YouTube link. Needs a token.
Inputs
- Issue ID
issue_idtextRequired - The issue's number, from 'List issues', an earlier step or its page address (seeclickfix.com/issues/23137041).
- Comment
commenttextRequired - What to say.
- YouTube link
youtube_urltext - A YouTube video showing the problem.
Outputs
commentobject- The comment posted
issue_statustext- The issue's status now
moderatedtrue/false- True when SeeClickFix holds it for moderation first
Example output
{
"comment": {
"comment": "City of New Haven assigned this issue to Public Works",
"comment_id": "",
"commenter_id": 1354851,
"commenter_name": "City of New Haven",
"commenter_role": "Verified Official",
"created_at": "2026-10-30T11:05:21-04:00",
"image_url": "",
"issue_id": 23137041,
"updated_at": "2026-10-30T11:05:21-04:00",
"video_url": ""
},
"issue_status": "Acknowledged",
"moderated": false
}Get connected account
Get the SeeClickFix account the connection's token belongs to, including whether it may acknowledge issues. Needs a token.
Inputs
None.
Outputs
userobject- The connected account
Example output
{
"user": {
"can_acknowledge": true,
"civic_points": 0,
"closed_issue_count": 0,
"comments_count": 62,
"created_at": "2024-04-30T20:25:54-04:00",
"id": 3041552,
"name": "Jo Resident",
"reported_issue_count": 25,
"role": "Registered User"
}
}Get issue
Get one issue with its comments, the answers to its questions, who it is assigned to and its votes.
Inputs
- Issue ID
issue_idtextRequired - The issue's number, from 'List issues', an earlier step or its page address (seeclickfix.com/issues/23137041).
Outputs
issueobject- The issue
Example output
{
"issue": {
"acknowledged_at": "2026-10-30T11:20:00-04:00",
"address": "39 Beecher Pl New Haven, CT 06512, USA",
"assignee_name": "Public Works",
"closed_at": "2026-10-30T15:47:52-04:00",
"comment_count": 1,
"comments": [
{
"comment": "City of New Haven assigned this issue to Public Works",
"comment_id": "88412345",
"commenter_id": 1354851,
"commenter_name": "City of New Haven",
"commenter_role": "Verified Official",
"created_at": "2026-10-30T11:05:21-04:00",
"image_url": "",
"issue_id": 23137041,
"updated_at": "2026-10-30T11:05:21-04:00",
"video_url": ""
}
],
"created_at": "2026-10-30T11:05:10-04:00",
"description": "Leaf bags on Beecher Place were not picked up.",
"html_url": "https://seeclickfix.com/issues/23137041",
"id": 23137041,
"image_url": "",
"lat": 41.262437,
"lng": -72.892973,
"organization": "City of New Haven",
"questions": [
{
"answer": "3",
"question": "How many bags?"
}
],
"rating": 2,
"reopened_at": "",
"reporter_id": 3041552,
"reporter_name": "Jo Resident",
"request_type": "Missed Trash/Recycling",
"request_type_id": "43970",
"status": "Closed",
"summary": "Missed Trash/Recycling",
"updated_at": "2026-10-30T15:47:52-04:00",
"vote_count": 0
}
}Get place
Get one place by its id.
Inputs
- Place ID
place_idtextRequired - The place's id, from 'List places'.
Outputs
placeobject- The place
Example output
{
"place": {
"county": "New Haven",
"html_url": "https://seeclickfix.com/new-haven",
"id": 3039,
"lat": 41.310373,
"lng": -72.92416,
"name": "New Haven",
"place_type": "City",
"state": "CT",
"url_name": "new-haven"
}
}Get request type questions
Get the questions a request type asks when an issue is reported, with the answers each allows.
Inputs
- Request type ID
request_type_idtextRequired - The request type's id, from 'List request types at a point', or other.
Outputs
request_typeobject- The request type
Example output
{
"request_type": {
"block_submission": false,
"id": "43965",
"is_other": false,
"organization": "City of New Haven",
"permit_anonymous_reporting": true,
"questions": [
{
"answer_kept_private": false,
"primary_key": "142",
"question": "Depth of pothole?",
"question_type": "select",
"response_required": true,
"select_values": [
{
"key": "DEEP",
"name": "Deep Hole"
}
]
}
],
"title": "Accessibility for Persons with Disabilities"
}
}Get user
Get a SeeClickFix user's public profile: name, role and how many issues and comments they have posted.
Inputs
- User ID
seeclickfix_user_idtextRequired - The user's id, such as an issue's reporter_id.
Outputs
userobject- The user
Example output
{
"user": {
"can_acknowledge": false,
"civic_points": 0,
"closed_issue_count": 0,
"comments_count": 62,
"created_at": "2024-04-30T20:25:54-04:00",
"id": 3041552,
"name": "Jo Resident",
"reported_issue_count": 25,
"role": "Registered User"
}
}List issue comments
List every comment on an issue, oldest first.
Inputs
- Issue ID
issue_idtextRequired - The issue's number, from 'List issues', an earlier step or its page address (seeclickfix.com/issues/23137041).
Outputs
commentslist- The comments
countnumber- How many
issue_idnumber- The issue
Example output
{
"comments": [
{
"comment": "City of New Haven assigned this issue to Public Works",
"comment_id": "88412345",
"commenter_id": 1354851,
"commenter_name": "City of New Haven",
"commenter_role": "Verified Official",
"created_at": "2026-10-30T11:05:21-04:00",
"image_url": "",
"issue_id": 23137041,
"updated_at": "2026-10-30T11:05:21-04:00",
"video_url": ""
}
],
"count": 1,
"issue_id": 23137041
}List issues
List reported issues in a place or around a point, by status, request type, words, and when they were reported or updated. Returns one page; ask for the next with 'Page'.
Inputs
- Place
placetext - Only issues in this place: its URL name, the part after seeclickfix.com/ in its page address (new-haven), or the address pasted whole. 'List places' finds one.
- Latitude
latitudenumber - With a longitude, only issues around this point.From -90 to 90.
- Longitude
longitudenumber - With a latitude, only issues around this point.From -180 to 180.
- Statuses
statuseslist - Only issues with these statuses. Defaults to open, acknowledged and closed.One or more of:
open,acknowledged,closed,archived. - Request type
request_type_idtext - Only issues of this request type. The list offers the types at the point given.
- Search
searchtext - Only issues matching these words.
- Reported after
created_afterdate and time - Only issues reported at or after this time.
- Reported before
created_beforedate and time - Only issues reported before this time.
- Updated after
updated_afterdate and time - Only issues changed at or after this time.
- Updated before
updated_beforedate and time - Only issues last changed before this time.
- Sort by
sorttext - How to order them. Defaults to newest reported.One of:
created_at(Newest reported),updated_at(Last updated),rating(Highest rated),distance(Closest to the point). - Order
sort_directiontext - Descending (the default) or ascending.One of:
DESC(Descending),ASC(Ascending). - Page
pagenumber - Which page of results, starting at 1.From 1 to 100000.
- Per page
per_pagenumber - How many to return, 1 to 100. Defaults to 20. SeeClickFix sends at least 10.From 1 to 100.
Outputs
countnumber- How many
issueslist- The issues
next_pagenumber- The next page's number, 0 on the last
pagenumber- This page's number
pagesnumber- How many pages there are
totalnumber- How many there are in all
Example output
{
"count": 1,
"issues": [
{
"acknowledged_at": "2026-10-30T11:20:00-04:00",
"address": "39 Beecher Pl New Haven, CT 06512, USA",
"assignee_name": "Public Works",
"closed_at": "2026-10-30T15:47:52-04:00",
"comment_count": 1,
"comments": [],
"created_at": "2026-10-30T11:05:10-04:00",
"description": "Leaf bags on Beecher Place were not picked up.",
"html_url": "https://seeclickfix.com/issues/23137041",
"id": 23137041,
"image_url": "",
"lat": 41.262437,
"lng": -72.892973,
"organization": "City of New Haven",
"questions": [],
"rating": 2,
"reopened_at": "",
"reporter_id": 3041552,
"reporter_name": "Jo Resident",
"request_type": "Missed Trash/Recycling",
"request_type_id": "43970",
"status": "Closed",
"summary": "Missed Trash/Recycling",
"updated_at": "2026-10-30T15:47:52-04:00",
"vote_count": 0
}
],
"next_page": 0,
"page": 1,
"pages": 1,
"total": 1
}List places
List the places (cities, counties, neighborhoods) around a point, closest first, with the URL name that lists their issues.
Inputs
- Latitude
latitudenumberRequired - The latitude, such as 41.3083.From -90 to 90.
- Longitude
longitudenumberRequired - The longitude, such as -72.9279.From -180 to 180.
- Page
pagenumber - Which page of results, starting at 1.From 1 to 100000.
- Per page
per_pagenumber - How many to return, 1 to 100. Defaults to 20. SeeClickFix sends at least 10.From 1 to 100.
Outputs
countnumber- How many
next_pagenumber- The next page's number, 0 on the last
pagenumber- This page's number
pagesnumber- How many pages there are
placeslist- The places
totalnumber- How many there are in all
Example output
{
"count": 1,
"next_page": 0,
"page": 1,
"pages": 1,
"places": [
{
"county": "New Haven",
"html_url": "https://seeclickfix.com/new-haven",
"id": 3039,
"lat": 41.310373,
"lng": -72.92416,
"name": "New Haven",
"place_type": "City",
"state": "CT",
"url_name": "new-haven"
}
],
"total": 1
}List request types at a point
List the kinds of issue that can be reported at a point, and the organization that handles each.
Inputs
- Latitude
latitudenumberRequired - The latitude, such as 41.3083.From -90 to 90.
- Longitude
longitudenumberRequired - The longitude, such as -72.9279.From -180 to 180.
Outputs
countnumber- How many
request_typeslist- The request types
Example output
{
"count": 1,
"request_types": [
{
"block_submission": false,
"id": "43965",
"is_other": false,
"organization": "City of New Haven",
"permit_anonymous_reporting": true,
"title": "Accessibility for Persons with Disabilities"
}
]
}Report issue
Report a new issue at a point, as the connected account, with its request type, title, description and answers to the type's questions. It is public and goes to the organization handling that type. Needs a token.
Inputs
- Latitude
latitudenumberRequired - The latitude of the problem, such as 41.3083.From -90 to 90.
- Longitude
longitudenumberRequired - The longitude of the problem, such as -72.9279.From -180 to 180.
- Address
addresstextRequired - Where the problem is, in words, such as 165 Church St, New Haven.
- Request type
request_type_idtextRequired - What kind of problem it is. The list offers the types at the point given.
- Title
summarytextRequired - A short title for the issue, such as Pothole on Church St.
- Description
descriptiontext - More about the problem.
- Answers to the request type's questions
answersobject - The questions the chosen request type asks, filled in for you once a type is picked.
- Report anonymously
anonymize_reportertrue/false - Hide who reported it, where the request type allows.
Outputs
createdtrue/false- True once SeeClickFix gave it an id
issueobject- The new issue
moderatedtrue/false- True when SeeClickFix holds it for moderation first
Example output
{
"created": true,
"issue": {
"acknowledged_at": "2026-10-30T11:20:00-04:00",
"address": "39 Beecher Pl New Haven, CT 06512, USA",
"assignee_name": "Public Works",
"closed_at": "2026-10-30T15:47:52-04:00",
"comment_count": 1,
"comments": [],
"created_at": "2026-10-30T11:05:10-04:00",
"description": "Leaf bags on Beecher Place were not picked up.",
"html_url": "https://seeclickfix.com/issues/23137041",
"id": 23137041,
"image_url": "",
"lat": 41.262437,
"lng": -72.892973,
"organization": "City of New Haven",
"questions": [
{
"answer": "3",
"question": "How many bags?"
}
],
"rating": 2,
"reopened_at": "",
"reporter_id": 3041552,
"reporter_name": "Jo Resident",
"request_type": "Missed Trash/Recycling",
"request_type_id": "43970",
"status": "Open",
"summary": "Missed Trash/Recycling",
"updated_at": "2026-10-30T15:47:52-04:00",
"vote_count": 0
},
"moderated": false
}