Value Type

LongValue

Wrapper type for long integer values

Wraps primitive:long

LongValue

A wrapper type that encapsulates a long (64-bit integer) value in API requests and responses.

Overview

LongValue is used in the Acumatica API to wrap 64-bit integer properties. This type is used for fields that may contain very large numbers.

JSON Structure

{
  "value": 9223372036854775807
}

Examples

Reading a LongValue

{
  "RecordID": {
    "value": 1234567890123
  }
}

Setting a LongValue

{
  "RecordID": {
    "value": 9876543210987
  }
}

Properties

PropertyTypeDescription
valuelong64-bit signed integer
errorstringError message describing validation or processing issues with this field

Error Handling

All value wrapper types inherit an error property that contains a description when there is an issue with the field. Always check this property when processing API responses.

Value Range

  • Minimum: -9,223,372,036,854,775,808
  • Maximum: 9,223,372,036,854,775,807

Common Fields Using LongValue

  • Large record identifiers
  • Timestamp values (as ticks)
  • Large counter or sequence fields