---
title: "List the recognition queue, paginated and filtered, newest first"
method: GET
path: "/v1/admin/floorplan-recognition-requests"
tags: ["Admin Floorplan Recognition Requests"]
---

# List the recognition queue, paginated and filtered, newest first

`GET /v1/admin/floorplan-recognition-requests`

## Query parameters

- `limit` integer
- `cursor` string
- `direction` 'after' | 'before'
- `status` 'all' | 'open' | 'unassigned' | 'assigned' | 'completed' | 'cancelled'
- `q` string
- `assigneeId` union
  - string, uuid
  - 'unassigned'
- `from` unknown
- `to` unknown

## Response `200`

Recognition queue retrieved successfully

- FloorplanRecognitionQueuePaginatedApiResponseDto
  - `success` boolean, required — Indicates if the request was successful
  - `message` string, required — Human readable message
  - `data` object[], required — Array of data items
    - `recognitionId` string, uuid, required
    - `userId` string, uuid, required — Customer whose plan needs a recognition request
    - `projectId` string, uuid, required
    - `source` union, required
      - object
        - `kind` 'single_image', required
        - `inputs` object[], required
          - `assetId` string, uuid, required
          - `pageNumber` unknown, required
      - object
        - `kind` 'multi_image', required
        - `inputs` object[], required
          - `assetId` string, uuid, required
          - `pageNumber` unknown, required
      - object
        - `kind` 'pdf', required
        - `inputs` object[], required
          - `assetId` string, uuid, required
          - `pageNumber` integer, required
    - `aiResult` object, nullable, required — Present when AI already produced a terminal result before this recognition routed to a human (escalation), null for a human-only recognition
      - `recognitionId` string, uuid, required
      - `outcome` 'success' | 'partial' | 'failure', required
      - `floors` union[], required
        - union
          - object
            - `inputIndex` integer, required
            - `outputLevels` object[], required
              - …
            - `outcome` 'success', required
            - `errorReason` unknown, required
            - `preprocessedAssetId` string, uuid, required
            - `preprocessedHelperAssetId` string, uuid, nullable, required
          - object
            - `inputIndex` integer, required
            - `outputLevels` object[], required
              - …
            - `outcome` 'failure', required
            - `errorReason` string, required
            - `preprocessedAssetId` string, uuid, nullable, required
            - `preprocessedHelperAssetId` string, uuid, nullable, required
      - `scaleSource` 'printed_dimensions' | 'user_annotation' | 'target_dimensions' | 'fallback', required
      - `scaleConfidence` number, required
      - `floorplanType` object, nullable, required
        - `category` 'residential' | 'commercial' | 'mixed_use' | 'unknown', required
        - `displayLabel` string, required
        - `confidence` number, required — Classifier confidence, 0..1
      - `completedAt` string, date-time, required
    - `summaryText` string, nullable, required — Summary of the request's context, captured at creation
    - `status` 'open' | 'completed' | 'cancelled', required
    - `assignedToUserId` string, uuid, nullable, required
    - `escalationStatus` 'unattempted' | 'attempting' | 'succeeded' | 'failed', required
    - `customerEmail` string, nullable, required
    - `customerName` string, nullable, required
    - `assigneeName` string, nullable, required
    - `deliveredPlans` object[], required — Floorplans delivered for this request (floorplan_recognition_outputs rows with role=human_delivery)
      - `id` string, uuid, required
      - `name` string, required
    - `createdAt` unknown, required
    - `updatedAt` unknown, required
  - `meta` object, required — Pagination metadata
    - `hasNext` boolean, required — Whether there are more items after current set
    - `hasPrevious` boolean, required — Whether there are items before current set
    - `nextCursor` string, nullable, required — Cursor for next page
    - `prevCursor` string, nullable, required — Cursor for previous page
    - `totalCount` integer, required — Rows matching the current filters, independent of cursor position
  - `timestamp` string, date-time, required — Timestamp of the response

---

[API](https://skmtc.dev/maket/apis/virtual-architect-api.md) · [All operations](https://skmtc.dev/maket/apis/virtual-architect-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/maket/virtual-architect-api/revisions/b712097baa9c/schema)