---
title: "Register Cloud Device"
method: POST
path: "/v5/devices"
tags: ["Devices"]
---

# Register Cloud Device

`POST /v5/devices`

## Request

- Base URL: `https://sandbox.nmi.com/api`
- URL: `https://sandbox.nmi.com/api/v5/devices`
- Auth: API key in header `Authorization`

Register a new cloud device with the merchant using a registration code.

## Request body

- RegisterDeviceRequest: Request to register a new cloud device
  - `registration_code` string, required: The registration code provided with the device
  - `nickname` string: Optional nickname for the device
  - `default` boolean: Whether to set this device as the default cloud device for the merchant

## Response `201`

Device registered successfully

- DeviceResponse: Response containing cloud device data
  - `object` 'device', required: String representing the object's type. Always 'device' for device objects.
  - `id` string, required: Unique identifier for the device
  - `device_nickname` string, nullable: Nickname assigned to the device
  - `make` string, nullable: Device manufacturer
  - `model` string, nullable: Device model
  - `serial_number` string, nullable: Device serial number
  - `registration_status` 'registered' | 'deregistered', required: Current registration status of the device
  - `last_transaction_date` string, date-time, nullable: Date and time of the last transaction processed on this device
  - `date_registered` string, date-time, nullable: Date and time when the device was registered
  - `date_deregistered` string, date-time, nullable: Date and time when the device was deregistered
  - `connection_status` boolean, nullable: Whether the device is currently connected
  - `last_connected_date` string, date-time, nullable: Date and time when the device was last connected
  - `last_disconnected_date` string, date-time, nullable: Date and time when the device was last disconnected
  - `battery_info` object, nullable: Battery information (only included when current_status=true)
  - `wifi_info` object, nullable: WiFi information (only included when current_status=true)

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

---

[API](https://skmtc.dev/nmi/apis/payments-api.md) - [All operations](https://skmtc.dev/nmi/apis/payments-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nmi/apis/payments-api/revisions/c03727f27e27?raw)