---
updatedAt: 2025-08-11T18:18:17.000Z
agentTools:
  projectIndex: https://docs.keycafe.com/llms.txt
---

# Exchange Object

| Field       | Type            | Description                                                                                                                                                                                                                |
| ----------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id          | integer (int64) | The unique identifier for the object.                                                                                                                                                                                      |
| type        | string          | The exchange type (PICKUP, DROPOFF, ACTIVATION).                                                                                                                                                                           |
| dateCreated | date-time       | The timestamp of the exchange authorization, in ISO 8601 format without milliseconds.                                                                                                                                      |
| user        | object          | The user who is performing the exchange.                                                                                                                                                                                   |
| key         | object          | The key for which the exchange is being performed.                                                                                                                                                                         |
| location    | object          | The location at which the exchange is being performed.                                                                                                                                                                     |
| completed   | boolean         | If true, the exchange has successfully completed.                                                                                                                                                                          |
| cancelled   | boolean         | If true, the exchange has failed or timed out.                                                                                                                                                                             |
| released    | boolean         | If true, the SmartBox has confirmed a successful bin release. A drop-off is completed when the release is authorized. It is possible for `completed` to be true and `released` to be false while waiting for confirmation. |
| expansion   | boolean         | If true, the bin involved in the exchange is contained in an expansion unit. Useful for displaying additional user instructions.                                                                                           |
| error       | string          | If an exchange fails during interaction with the SmartBox, an error code will be included.                                                                                                                                 |

# Error

| Code            | Description                                                                              |
| --------------- | ---------------------------------------------------------------------------------------- |
| OWNER\_ONLY     | The location does not support exchanges performed by users other than the network owner. |
| WRONG\_LOCATION | The user has attempted to complete an exchange at the wrong location.                    |
| INVALID\_FOB    | The scanned fob cannot be used to complete the activation.                               |