# SeeClickFix

> 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.

App · 12 actions. Web page: https://docs.lodol.com/docs/integrations/seeclickfix

## Actions

### 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_id`, text, required): The issue's number, from 'List issues', an earlier step or its page address (seeclickfix.com/issues/23137041).
- Change to (`status`, text, required): Acknowledge, close or reopen the issue. One of: `acknowledged` (Acknowledge), `closed` (Close), `open` (Reopen).
- Comment (`comment`, text, required): Why, posted on the issue with the change.

**Outputs**

- `comment` (object): The comment posted
- `issue_status` (text): The issue's status now
- `moderated` (true/false): True when SeeClickFix holds it for moderation first

**Example output**

```json
{
  "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_id`, text, required): The issue's number, from 'List issues', an earlier step or its page address (seeclickfix.com/issues/23137041).
- Comment (`comment`, text, required): What to say.
- YouTube link (`youtube_url`, text): A YouTube video showing the problem.

**Outputs**

- `comment` (object): The comment posted
- `issue_status` (text): The issue's status now
- `moderated` (true/false): True when SeeClickFix holds it for moderation first

**Example output**

```json
{
  "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**

- `user` (object): The connected account

**Example output**

```json
{
  "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_id`, text, required): The issue's number, from 'List issues', an earlier step or its page address (seeclickfix.com/issues/23137041).

**Outputs**

- `issue` (object): The issue

**Example output**

```json
{
  "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_id`, text, required): The place's id, from 'List places'.

**Outputs**

- `place` (object): The place

**Example output**

```json
{
  "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_id`, text, required): The request type's id, from 'List request types at a point', or other.

**Outputs**

- `request_type` (object): The request type

**Example output**

```json
{
  "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_id`, text, required): The user's id, such as an issue's reporter_id.

**Outputs**

- `user` (object): The user

**Example output**

```json
{
  "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_id`, text, required): The issue's number, from 'List issues', an earlier step or its page address (seeclickfix.com/issues/23137041).

**Outputs**

- `comments` (list): The comments
- `count` (number): How many
- `issue_id` (number): The issue

**Example output**

```json
{
  "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 (`place`, text): 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 (`latitude`, number): With a longitude, only issues around this point. From -90 to 90.
- Longitude (`longitude`, number): With a latitude, only issues around this point. From -180 to 180.
- Statuses (`statuses`, list): Only issues with these statuses. Defaults to open, acknowledged and closed. One or more of: `open`, `acknowledged`, `closed`, `archived`.
- Request type (`request_type_id`, text): Only issues of this request type. The list offers the types at the point given.
- Search (`search`, text): Only issues matching these words.
- Reported after (`created_after`, date and time): Only issues reported at or after this time.
- Reported before (`created_before`, date and time): Only issues reported before this time.
- Updated after (`updated_after`, date and time): Only issues changed at or after this time.
- Updated before (`updated_before`, date and time): Only issues last changed before this time.
- Sort by (`sort`, text): 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_direction`, text): Descending (the default) or ascending. One of: `DESC` (Descending), `ASC` (Ascending).
- Page (`page`, number): Which page of results, starting at 1. From 1 to 100000.
- Per page (`per_page`, number): How many to return, 1 to 100. Defaults to 20. SeeClickFix sends at least 10. From 1 to 100.

**Outputs**

- `count` (number): How many
- `issues` (list): The issues
- `next_page` (number): The next page's number, 0 on the last
- `page` (number): This page's number
- `pages` (number): How many pages there are
- `total` (number): How many there are in all

**Example output**

```json
{
  "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 (`latitude`, number, required): The latitude, such as 41.3083. From -90 to 90.
- Longitude (`longitude`, number, required): The longitude, such as -72.9279. From -180 to 180.
- Page (`page`, number): Which page of results, starting at 1. From 1 to 100000.
- Per page (`per_page`, number): How many to return, 1 to 100. Defaults to 20. SeeClickFix sends at least 10. From 1 to 100.

**Outputs**

- `count` (number): How many
- `next_page` (number): The next page's number, 0 on the last
- `page` (number): This page's number
- `pages` (number): How many pages there are
- `places` (list): The places
- `total` (number): How many there are in all

**Example output**

```json
{
  "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 (`latitude`, number, required): The latitude, such as 41.3083. From -90 to 90.
- Longitude (`longitude`, number, required): The longitude, such as -72.9279. From -180 to 180.

**Outputs**

- `count` (number): How many
- `request_types` (list): The request types

**Example output**

```json
{
  "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 (`latitude`, number, required): The latitude of the problem, such as 41.3083. From -90 to 90.
- Longitude (`longitude`, number, required): The longitude of the problem, such as -72.9279. From -180 to 180.
- Address (`address`, text, required): Where the problem is, in words, such as 165 Church St, New Haven.
- Request type (`request_type_id`, text, required): What kind of problem it is. The list offers the types at the point given.
- Title (`summary`, text, required): A short title for the issue, such as Pothole on Church St.
- Description (`description`, text): More about the problem.
- Answers to the request type's questions (`answers`, object): The questions the chosen request type asks, filled in for you once a type is picked.
- Report anonymously (`anonymize_reporter`, true/false): Hide who reported it, where the request type allows.

**Outputs**

- `created` (true/false): True once SeeClickFix gave it an id
- `issue` (object): The new issue
- `moderated` (true/false): True when SeeClickFix holds it for moderation first

**Example output**

```json
{
  "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
}
```
