# Remote Retrieval

Remote Retrieval automates the logistics of managing equipment returns, providing efficient tracking and management of laptop and monitor returns.

- **Category:** it operations
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 7
- **Triggers:** 0
- **Slug:** `REMOTE_RETRIEVAL`
- **Version:** 20260223_00

## Tools

### Create Order

**Slug:** `REMOTE_RETRIEVAL_CREATE_ORDER`

Tool to create IT asset retrieval orders for remote employees. Use when you need to schedule pickup of laptops, monitors, cell phones, or tablets from employees. Supports both return-to-company and recycle-with-data-destruction workflows.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `orders` | array | Yes | List of order items to create. Can create single or multiple orders in one request |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get All Orders

**Slug:** `REMOTE_RETRIEVAL_GET_ALL_ORDERS`

Tool to retrieve a paginated list of all orders. Use when you need to list orders with optional filters like status or dates. Call after authentication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (must be ≥ 1). |
| `status` | string | No | Filter orders by status, e.g., 'pending' or 'completed'. |
| `to_date` | string | No | ISO 8601 end date for filtering orders, e.g., '2023-01-31T23:59:59Z'. |
| `per_page` | integer | No | Number of orders per page (1–100). |
| `from_date` | string | No | ISO 8601 start date for filtering orders, e.g., '2023-01-01T00:00:00Z'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Company Details

**Slug:** `REMOTE_RETRIEVAL_GET_COMPANY_DETAILS`

Tool to retrieve detailed information for a company. Use after confirming a valid company_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company_id` | string | Yes | Unique identifier for the company |
| `expand_contacts` | boolean | No | Whether to include company contact details |
| `industry_filter` | string | No | Filter results by industry category |
| `include_financials` | boolean | No | Whether to include financial data |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Device Prices

**Slug:** `REMOTE_RETRIEVAL_GET_DEVICE_PRICES`

Tool to retrieve real-time pricing data for all supported devices. Use when you need current prices for Laptop, Monitor (17-23 inch), Monitor_27 (24-27 inch), Tablet, or Cell Phone.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Order Details

**Slug:** `REMOTE_RETRIEVAL_GET_ORDER_DETAILS`

Tool to retrieve specific order details by order ID. Use when you need detailed information about an order including employee info, company info, and shipment status (device_type, send_status, return_status).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `oid` | string | Yes | Order ID to retrieve details for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Pending Orders

**Slug:** `REMOTE_RETRIEVAL_LIST_PENDING_ORDERS`

Tool to retrieve list of all pending orders. Use when you need to check orders awaiting payment completion. Results are paginated up to 25 per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. Results are paginated up to 25 per page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### RemoteRetrieval: Validate User

**Slug:** `REMOTE_RETRIEVAL_VALIDATE_USER`

Tool to validate the provided API key. Use when you need to confirm the API key's validity.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |