AcuView API Field Formats

Strings

Many string fields returned by the AcuView API, such as names, addresses, and merchant identifiers, are reported exactly as provided by the client or stored in the system. The API does not currently impose strict maximum length limits on these fields. In practice, values such as customer names and addresses should be stored using reasonable length allocations (for example, 255 characters for a name field). Where sensitive data such as Social Security Numbers or bank account numbers are used, AcuView recommends storing only masked values (for example, the last 4 digits). This ensures data privacy and compliance while maintaining referential integrity.

Numbers and money

AcuView represents all monetary amounts, such as loan requests, approved loan amounts, and income values, as numeric fields without currency symbols. Values are generally returned as integers or floating-point numbers. For example, a requested loan amount may appear as 7000 instead of $7,000.00. Developers should implement support for standard precision in currency fields and avoid relying on string formatting for monetary operations.

Dates

Dates in AcuView requests and responses use the ISO 8601 format YYYY-MM-DD. For example, a borrower’s date of birth would be represented as "1985-04-15". This ensures consistency across integrations and eliminates ambiguity in regional date formats.

Datetimes

Timestamps are returned using full ISO 8601 date-time notation with UTC offsets. For instance, a loan record’s added date may appear as "2025-08-14T07:15:42.7372624Z". This standardization allows integrators to correctly sort, filter, and analyze records across different time zones. For time-sensitive operations, AcuView requires the inclusion of the X-Timezone header in requests so that events can be recorded relative to the client’s local time.

Enums

Several AcuView fields return a limited set of enumerated values. Loan status values can include Pending, Approved, Denied, PaidOff, or WrittenOff, while account verification operations may return Match, Warning, or NotFound. By enforcing strict enums, AcuView ensures that client applications can reliably interpret system outcomes without ambiguity.

Identifiers

Every AcuView resource is uniquely identified by an alphanumeric string. Loan records, for example, are represented by a 24-character ID, while merchant identifiers are shorter alphanumeric values such as "1RAMGSK9". These identifiers should be treated as opaque values and not parsed or truncated.