Last updated

Field Specifications

NPS APIs support a common set of field definitions.

Field Types

Type
Details
Allowed Values
Default Values
BooleanTrue
False
Integer64 bits[0-9]
Big Decimal
Float
Double
32 bits.[0-9]
String* Unicode 16
* deserialize "null" -> NULL
* serialize never produce "null" if it is null
.*
ListLarge lists use paginationempty
CurrencyISO4127USD
Country CodeISO2166-1/3US or USA
RegionISO3166[A-Z]{2:3}null
DatetimeISO86012026-07-04T13:33:03.969Z
Date 2026-07-04
Enum Values are UPPERCASE[A-Z]*

Note: Values labeled as null are not returned as int(0) or string("null"). They are returned as null objects.

Common Fields

FieldTypeDescription
amountbig decimalThe amount of the transaction.
firstNamestringThe user's first or given name.
lastNamestringThe user's last or surname.
usernamestringA unique identifier, account name, or login name identifying a user with access to an account or resource.
passwordstringA string of characters used to confirm a user's identity. When the password is correctly matched to the username, the user will receive access to an account or resource.
userStatusenumThe status of the user's account.
lastLoggedIndatetimeThe last day and time a user logged in.