> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bimengine.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Submissions

> GET/PATCH /api/gov/submissions

## List submissions

```bash theme={null}
GET /api/gov/submissions
```

### Parameters

| Parameter | Type     | Description                                                              |
| --------- | -------- | ------------------------------------------------------------------------ |
| `status`  | `string` | Filter: `PENDING`, `IN_REVIEW`, `APPROVED`, `REJECTED`, `NEEDS_RESPONSE` |

### Response

```json theme={null}
{
  "submissions": [
    {
      "id": "sub_abc123",
      "status": "PENDING",
      "submittedAt": "2026-03-01T10:00:00Z",
      "round": 1,
      "assignedTo": null,
      "profile": {
        "address": "123 Main St",
        "city": "Austin",
        "state": "TX",
        "firmId": "firm_xyz",
        "verdictSummary": {
          "overall": "YELLOW",
          "passCount": 18,
          "failCount": 2,
          "needsReviewCount": 5
        }
      },
      "jurisdiction": { "name": "City of Austin" }
    }
  ],
  "total": 42
}
```

## Get submission detail

```bash theme={null}
GET /api/gov/submissions/:reviewId
```

Returns the full submission with nested `profile.categories[].items[]` and `reviewActions[]`.

## Update submission

```bash theme={null}
PATCH /api/gov/submissions/:reviewId
```

### Body

| Field        | Type      | Description                            |
| ------------ | --------- | -------------------------------------- |
| `status`     | `string`  | `IN_REVIEW`, `APPROVED`, or `REJECTED` |
| `assignToMe` | `boolean` | Assign to current user                 |

Returns updated submission.