Intuit RealmIds are changing November 14: Are you prepared?

If your application stores Intuit Realm or Company Ids as integers in a data store, then please read carefully because new realmIds will be larger than an integer.

Note: This is a reminder of an announcement we made in late 2014.

What action is required?

You must ensure your application can accommodate the new long RealmId format that will be in production on November 19th, 2015.

In Simple terms:

long NewrealmId = 9223372036854775807 > int realmId = 2147483647;


What’s happening?

RealmIds are the numeric identifiers that Intuit Identity Services uses to identify a QuickBooks company record. The current format is a 10-digit integer. At the current rate, we will run out of IDs in about a year in the production environment. To address this, we are changing the RealmId type from Integer (16-bit) to Long (64-bit).

Note: Existing RealmIds will be unchanged. Only new RealmIds will get the Long type.

Modifying your code if necessary!

Intuit has documented the RealmId as a string for 3rd-party developers. The underneath implementation will change from integer to long. Depending on how you define the RealmId, you might need to modify your code. You need to modify your code if any of these scenarios applies:

  • If you define RealmId as int or Integer, change it to long or Long, and ensure the validation for the long RealmIds.
  • If you define RealmId as String and validate the string, make sure the validation logic (checking the string length) accommodates the maximum string size as 19 (positive RealmIds only) instead of 10.
  • If you have a database table to store IDs, make sure it can hold 64-bit numbers.

Need help?

If you have any questions, concerns or comments, please share them on our developer forums.






Leave a Reply

Your email address will not be published. Required fields are marked *