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

# Add Finder Result to Shortlist

> Save a Finder result to the team shortlist

<Info>
  For a new domain, matching URLs in that search are grouped into one shortlist item and those results are removed from the search. If the domain is already on the shortlist, the existing item is returned unchanged.
</Info>

## Body Parameters

<ParamField body="search_id" type="string" required>
  Finder search ID that contains the result
</ParamField>

<ParamField body="result_id" type="string" required>
  Finder result ID to save
</ParamField>

## Response

The response includes the shortlist item.

<ResponseField name="success" type="boolean">
  Always `true` for successful responses
</ResponseField>

<ResponseField name="data" type="object">
  The shortlist item.

  <Expandable title="Data Object Properties">
    <ResponseField name="id" type="string">
      Unique identifier for the shortlist item
    </ResponseField>

    <ResponseField name="name" type="string">
      Opportunity name
    </ResponseField>

    <ResponseField name="domain" type="string">
      Opportunity domain
    </ResponseField>

    <ResponseField name="urls" type="string[]">
      URLs grouped into this shortlist item
    </ResponseField>

    <ResponseField name="category" type="string">
      Opportunity category
    </ResponseField>

    <ResponseField name="emails" type="string[]">
      Saved contact emails
    </ResponseField>

    <ResponseField name="social_media" type="string[]">
      Saved social profile URLs
    </ResponseField>

    <ResponseField name="notes" type="string | null">
      Notes, or `null` if unset
    </ResponseField>

    <ResponseField name="status" type="string | null">
      Workflow status, or `null` if unset
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of when the item was created
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp of when the item was last updated
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.affonso.io/v1/finder/shortlist" \
    -H "Authorization: Bearer sk_live_your_api_key" \
    -H "Content-Type: application/json" \
    -d '{
      "search_id": "cmk2q1wau0001sb01lpvka001",
      "result_id": "cmk2q1wau0002sb01lpvka002"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "id": "cmk2q1wau0003sb01lpvka003",
      "name": "Example",
      "domain": "example.com",
      "urls": [
        "https://example.com/article"
      ],
      "category": "google",
      "emails": [],
      "social_media": [],
      "notes": null,
      "status": "NEW",
      "created_at": "2026-08-28T00:00:00.000Z",
      "updated_at": "2026-08-28T00:00:00.000Z"
    }
  }
  ```
</ResponseExample>

## Errors

| Status | Code               | Description                       |
| ------ | ------------------ | --------------------------------- |
| `400`  | `VALIDATION_ERROR` | Invalid request body              |
| `404`  | `NOT_FOUND`        | Finder result or search not found |

## Notes

* Requires the `write:finder` permission.
* Shortlisting results does not refund discovery credits for that search.