# Trade-in Device API

- Human documentation: https://www.myrepairapp.com/api-docs/trade-ins
- OpenAPI: https://www.myrepairapp.com/openapi.json
- Last updated: 2026-07-30T23:34:32.145Z

## The Trade-in Device Model

The Trade-in Device Item object represents a device that is being traded in the system. Below is an example of a Trade-in Device Item object with all possible fields.

```json
{
  "carrier": "Verizon",
  "color": "White",
  "condition": "Grade A",
  "manufacturer": "Apple",
  "deviceType": "Phones",
  "model": "iPhone 13 Pro",
  "password": "",
  "serialNumber": "332132131AA",
  "status": "Opened",
  "storage": "256GB",
  "patternLock": "[]",
  "quoteValue": "100",
  "tradeinDevice": true,
  "additionalInfo": "Includes original box and accessories"
}
```

### Trade-in Device Object Properties

| Field            | Type      | Required | Description                                       |
| ---------------- | --------- | -------- | ------------------------------------------------- |
| `color`          | `string`  | No       | The color of the device.                          |
| `manufacturer`   | `string`  | No       | The manufacturer of the device.                   |
| `deviceType`     | `DeviceType`  | Yes      | The type of device (e.g., Tablets, Computers).    |
| `model`          | `string`  | Yes      | The device model name.                   |
| `storage`        | `string`  | Yes      | The storage capacity of the device.               |
| `carrier`        | `string`  | No       | The carrier associated with the device.           |
| `quoteValue`     | `string`  | Yes      | The quoted value of the trade-in device.          |
| `serialNumber`   | `string`  | Yes      | The serial number of the device.                  |
| `condition`      | `string`  | No       | The condition of the device.                      |
| `sku`            | `string`  | No       | The SKU of the device. If not provided a random one will be generated.                            |
| `additionalInfo` | `string`  | No       | Additional information about the trade-in device. |

#### Allowed Device Types

- Tablets
- Computers
- Phones
- Gaming
- Other
- Wearables

---

## Trade-in Resources

### Search trade-ins

This endpoint returns a list of all trade-ins.

#### HTTP Request

```http
GET https://www.myrepairapp.com/api/v2/inventory/trade-in
```

#### Query Parameters

| Parameter       | Type     | Required | Description                                       |
| --------------- | -------- | -------- | ------------------------------------------------- |
| `query`         | `string` | No      | Search term to filter inventory items (can be sku, part of item name, etc).        |
| `page`   | `number` | No       | Pagination page. |
| `pageSize`   | `string` | No       | Pagination page size. When not provided defaults to 50 IF page parameter was provided, doesn't limit results otherwise. |

#### Response

If successful, the response will include a list of trade-ins that fulfill the search criteria.

---

### Create a trade-in

This endpoint creates a list of new trade-in devies.

#### HTTP Request

```http
POST https://www.myrepairapp.com/api/v2/inventory/trade-in
```

#### Request Body

The request body must contain a valid list of TradeIn objects.

```json
[
  {
    "carrier": "Verizon",
    "color": "White",
    "condition": "Grade A",
    "manufacturer": "Apple",
    "deviceType": "Phones",
    "item": "iPhone 13 Pro",
    "model": "iPhone 13 Pro",
    "password": "",
    "serialNumber": "332132131AA",
    "status": "Opened",
    "storage": "256GB",
    "patternLock": "[]",
    "quoteValue": "100",
    "tradeinDevice": true,
    "additionalInfo": ""
  }
]
```


#### Response

If successful, the response will include the trade-ins' inventory record details after creation.

```json
{
  "createdItems": [
    {
      "id": "019a9d93-ed50-7690-a78b-8283938sajsj",
      "storeId": "42eb713e-1aa3-4b9f-a6e8-3f9e246b5466",
      "groupingId": null,
      "sku": "TRADEIN-ce016b5",
      "manufacturer": "Apple",
      "category": "Device",
      "type": "Device - Phone",
      "name": "iPhone 13 Pro",
      "cost": 100,
      "inventoried": true,
      "serialized": false,
      "instock": 1,
      "condition": "Used",
      "bin": "",
      "supplierId": null,
      "price": 100,
      "createdAt": "2025-11-19T19:25:08.816Z",
      "updatedAt": "2025-11-19T19:25:08.816Z",
      "note": "",
      "active": true,
      "serialNum": "332132131AA",
      "isRebate": false,
      "taxFree": false,
      "repairProvider": null,
      "tradeinDevice": true,
      "storage": "256GB",
      "color": "White",
      "carrier": "Verizon",
      "tradeInCondition": "Grade A",
      "tradeInStatus": null,
      "additionalInfo": "",
      "isMotorolaSku": null,
      "pulled": 0,
      "backOrdered": 0
    }
  ]
}
```