Remote CIK Lookup


#1

Is it possible to remotely lookup a CIK say from a Serial Number (unique identifier)?


#2

Found the answer to my own question… I did not see the Portal API beta before I posted.


#3

Just to follow up on this:
Assumptions:

  1. That your back-end application will be making this call, which will have access to the owner CIK (Portal CIK in this case) and the Vendor Token.
  2. All devices are used in one portal in the portals subdomain, and a different user app is in place which takes care of users and how they add and interact with device data.

To query to get a CIK for a device, there are two approaches.

  1. Use the Portal CIK (owner CIK) that you put all devices into and call the list RPC and then call info on each to get each individual one’s CIK (the key option using the info command). This will allow you to find the CIK you are looking for but you will need to make sure the Unique identifiers are put into meta info for the device client and/or make the alias of the client the unique identifier. Making the alias the unique identifier will make for quicker look-up, since you could skip the listing call and just call the info command using the alias.

http://docs.exosite.com/rpc/#listing
http://docs.exosite.com/rpc/#info

  1. The Vendor Fleet Management API calls for the provision system provide another approach that may be more of what you are looking for.

In this case, you will need to use the Vendor Token for the vendor provision calls

The first would be to make a call to get the client rid for your device using your model and serial number (unique id). You must use your vendor token for authorization to make this call.
GET /provision/manage/model//
http://docs.exosite.com/provision/management/#fleet-management-api-provision-manage-model-model-get-list-serial-numbers

Once you have the RID, you then call the info RPC detailed above, it will need the Portal CIK (owner CIK) to make that call or a higher level owner CIK.

If you need an entire list of serial numbers and their RIDs, you can use this call.
http://docs.exosite.com/provision/management/#fleet-management-api-provision-manage-model-model-get-list-serial-numbers


#4

Mike,

Where do you find the Portal CIK? I found the Portal RID, but I haven’t been able to find the CIK.

-Adam


#5

By default you can find the CIK of portals that you own from your /account/portals page. This is accessed by going to the ‘account’ view. Your view can be changed from the top right-hand menu of the Portals application. It is the drop-down menu underneath your username.

You can also modify the following URL to access this page directly:
https://mydomain.exosite.com/account/portals

@avance, I checked your subdomain and confirmed that it has this feature enabled. If you visit the page I have mentioned and do not see the portal CIK that you are looking for, odds are that you do not own the portal in question.

Feel free to post in here if you have general trouble, but if you encounter anything that is more application specific, or if the problem contains a CIK, please reach out to our help-desk.