---
title: "Get Match Suggestions (Internal)"
method: GET
path: "/internal/api/clients/{client_id}/intake-requests/{request_id}/match-suggestions"
tags: ["CLIENT", "Intake Requests"]
---

# Get Match Suggestions (Internal)

`GET /internal/api/clients/{client_id}/intake-requests/{request_id}/match-suggestions`

## Request

- Base URL: `https://api.signalshq.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.signalshq.io/internal/api/clients/{client_id}/intake-requests/{request_id}/match-suggestions`
- Auth: OAuth 2
  - Password
  - Token URL: `/auth/login`

Get pending match suggestions for 'other' uploads that match pending targeted items. Requires JWT (Bearer). Path: GET /internal/api/clients/{client_id}/intake-requests/{request_id}/match-suggestions

## Path parameters

- `request_id` string, uuid, required
- `client_id` string, uuid, required: Client ID

## Response `200`

Successful Response

- MatchSuggestionResponse[]
  - `document_id` string, uuid, required: ID of the document
  - `item_upload_id` string, uuid, required: ID of the intake request upload record (tenant_client_intake_request_uploads.id)
  - `current_item_id` string, uuid, required: ID of the current item (other/voluntary)
  - `suggested_item` MatchSuggestionSuggestedItem, required: Nested schema for suggested item details in match suggestion response.
    - `id` string, uuid, required: ID of the suggested item to match to
    - `document_type` string, required: Document type of the suggested item
    - `instance_name` string, nullable: Instance name requested for the suggested item
    - `document_classification` string, required: DEPRECATED raw classification string from automatic classification. Prefer document_type_identifier (resolved from the canonical document_type_id).
    - `document_type_identifier` string, nullable: Canonical document_identifier of the suggested-match document's CURRENT type, resolved from document_type_id. Stable routing/compare key; falls back to the legacy classification when the document has no canonical type id.
    - `classified_instance_name` string, nullable: Instance name from automatic classification
    - `match_confidence` number, required: Instance name match confidence score (0-100)
  - `request_title` string, required: Title of the intake request

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/signalshq/apis/signals-api.md) - [All operations](https://skmtc.dev/signalshq/apis/signals-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signalshq/apis/signals-api/revisions/2c22af3b5576?raw)