Docs Device ID, ICCID, or Serial Number lookup tool

Particle Updates
1

New lookup tool in the docs: It looks up Device ID, ICCID, or serial number with handy extra features:

  • Device ID lookup work for your developer devices, sandbox products, as well as organization products.
  • There’s also a button to claim it (if unclaimed), or rename it (if claimed).
  • ICCID lookup also works for sandbox and organization.
  • Serial number lookup ignores the mobile secret so if you have a wireless USB data matrix scanner you can just press the trigger and it will automatically look up the Device ID from serial number, then do a Device ID lookup.
  • For Chrome on Windows 10, Mac, Linux, and Chromebook it can also do the equivalent of particle identify with no software install.

https://docs.particle.io/tools/troubleshooting/lookup/

6 Likes
2

Hi Rickkas7,

Is there an API for this? We're creating our own product setup form and would like to auto-populate it with the device ID, FCC ID, IMEI, etc just by scanning the 2D barcode.

Thanks,
Hector

3

Yes, you can do that.

The format of the data matrix sticker is easy to parse to get the serial number (it's the part before the space).

Lookup device ID from serial number can convert the serial number to a device ID. However, there is a rate limit of 50 lookups per hour using the API.

The recommended flow is to import all of the devices in a bulk order to a product first. When you order in tray or reel from the Particle store you'll get an email with all of the devices in your order and importing this from the console is quick and easy. Billing doesn't start until the devices first connect to the cloud.

This is also necessary because you won't be able to get the rest of the information like ICCIDs until the device is either added to your product or claimed to an account. Then you can use get device information.

If you import first, you can just use [list devices in product])(Cloud API reference | Reference Documentation | Particle) instead of lookup device by serial number, and that has a significantly larger rate limit (10000 requests every 5 minutes).

If you are not building in bulk, you can scan the data matrix, use import device into product to import that one serial number. The response is a Device ID that you can then look up to get the rest of the information.

1 Like