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

# Retrieve Feedback

> Retrieve a single feedback item by ID

## Overview

Returns a single feedback item by its `fbk_` ID. Use it to poll a report as it moves through its status lifecycle so you know your report was seen and acted on.

Reads are strictly org-scoped. A feedback ID that belongs to another organization returns `404 not_found`, exactly like an ID that does not exist, so nothing leaks about other orgs' reports.

Any valid API key may read; no special scope is required. Retrieving feedback does not consume metered usage.

## Status lifecycle

Every report starts at `open` and moves forward as the Signa team works it:

| `status`       | Meaning                                                                                                                                                                          |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `open`         | Submitted and awaiting triage. This is the value on creation.                                                                                                                    |
| `acknowledged` | The team has seen the report and is investigating.                                                                                                                               |
| `resolved`     | The report is closed. `resolution_note` explains the outcome and `resolved_at` is stamped. A "won't fix" is a `resolved` with an explanatory note (there is no separate status). |

Poll this endpoint (or filter [List Feedback](/api-reference/administration/list-feedback) by `status`) to follow the transition.

## Path Parameters

<ParamField path="id" type="string" required>
  Feedback identifier (`fbk_...`) returned when you submitted the report.
</ParamField>

## Response

Same fields as a single [feedback object](/api-reference/administration/create-feedback#response).

<ResponseExample>
  ```json theme={null}
  {
    "id": "fbk_550e8400-e29b-41d4-a716-446655440000",
    "object": "feedback",
    "api_key_id": "key_1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    "type": "data_issue",
    "status": "resolved",
    "message": "The registered owner is out of date.",
    "resource_id": "tm_9f8e7d6c-5b4a-3210-fedc-ba9876543210",
    "request_ref": "req_01kpjabcdefghijkmnpqrstvwx",
    "field": "owner.name",
    "expected_value": "Acme Holdings LLC",
    "context": {
      "resource": {
        "found": true,
        "resource_type": "trademark",
        "office": "uspto",
        "jurisdiction": "US",
        "version": 3,
        "status_primary": "active",
        "source_updated_at": "2026-07-01T00:00:00.000Z",
        "updated_at": "2026-07-02T08:00:00.000Z"
      }
    },
    "resolution_note": "Corrected on the next USPTO sync; the assignment is now reflected.",
    "metadata": {},
    "created_at": "2026-07-10T12:40:00.000Z",
    "updated_at": "2026-07-11T09:15:00.000Z",
    "resolved_at": "2026-07-11T09:15:00.000Z",
    "request_id": "req_dX9pR4sU"
  }
  ```
</ResponseExample>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.signa.so/v1/feedback/fbk_550e8400-e29b-41d4-a716-446655440000" \
    -H "Authorization: Bearer sig_YOUR_KEY"
  ```

  ```typescript TypeScript theme={null}
  import { Signa } from "@signa-so/sdk";

  const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });

  const feedback = await signa.feedback.retrieve(
    "fbk_550e8400-e29b-41d4-a716-446655440000",
  );

  if (feedback.status === "resolved") {
    console.log("Resolved:", feedback.resolution_note);
  }
  ```
</CodeGroup>

## Errors

| Status | Type               | Description                                                                         |
| ------ | ------------------ | ----------------------------------------------------------------------------------- |
| 400    | `validation_error` | Malformed feedback ID (not a prefixed ID at all)                                    |
| 400    | `id_type_mismatch` | A well-formed ID of the wrong type (e.g. a `tm_...` where an `fbk_...` is expected) |
| 401    | `unauthorized`     | Missing or invalid API key                                                          |
| 404    | `not_found`        | Feedback does not exist or belongs to another organization                          |

## Related Endpoints

* [Submit Feedback](/api-reference/administration/create-feedback), file a new report
* [List Feedback](/api-reference/administration/list-feedback), paginated list with type and status filters