# List Revivn Asset Retrievals

Look up the status or tracking number of Revivn device returns

Fetches asset retrievals from [Revivn](https://revivn.com) so the agent can answer status questions about in-flight device returns — "where's my return box?", "has my old laptop shipped back yet?" — without anyone logging into Revivn.

## How It Works

The tool queries Revivn's retrievals and returns their current details, including order status and tracking number. Results can be filtered by:

- **Order number** — look up one specific retrieval
- **Serial number** — find the retrieval for a specific device
- **Created / updated date** — narrow to recent retrievals

Large result sets are paginated.

## Configuration

In the Risotto dashboard, select **Tools** in the sidebar. Select **Revivn** in the **Tool groups** list. Find **Revivn List Asset Retrievals V1** and click **Set up**. Fill in these settings, then click **Save**:

| Setting           | Required | Description                                                                                       |
| ----------------- | -------- | ------------------------------------------------------------------------------------------------- |
| **Host**          | Yes      | Revivn API base URL: `https://api.revivn.com` (production) or `https://api.revivn.dev` (sandbox). |
| **Client Id**     | Yes      | OAuth2 client ID issued by Revivn.                                                                |
| **Client Secret** | Yes      | OAuth2 client secret issued by Revivn. Stored encrypted.                                          |

> **Tip:** Use the same credentials as your [Create Revivn Asset
> Retrieval](https://www.tryrisotto.com/docs/integrations/tools/revivn/create_asset_retrieval) tool — both talk
> to the same Revivn environment, and retrievals created by one are visible to
> the other.

## Example Runbook Uses

- An offboarded employee asks where their return kit is — the agent looks up the retrieval by serial number and shares the tracking number
- IT audits last month's device returns by filtering on created date

## Troubleshooting

### A retrieval created in Risotto doesn't show up

Confirm both Revivn tools point at the same **Host** — a retrieval created in sandbox won't appear when listing against production, and vice versa.

### Authentication fails

Confirm the Client ID and Secret match the environment of the configured Host.

## Related

- [Create Revivn Asset Retrieval](https://www.tryrisotto.com/docs/integrations/tools/revivn/create_asset_retrieval) — file a new device-return request

Source: https://www.tryrisotto.com/docs/integrations/tools/revivn/list_asset_retrievals
