IntValue

A wrapper type that encapsulates an int (32-bit integer) value in API requests and responses.

Overview

IntValue is used throughout the Acumatica API to wrap integer properties. This wrapper pattern allows the API to distinguish between "no value provided" (field omitted) and "explicitly set to zero".

JSON Structure

{
  "value": 42
}

Examples

Reading an IntValue

When retrieving an entity, integer properties are returned as objects:

{
  "Quantity": {
    "value": 100
  },
  "LineNbr": {
    "value": 1
  }
}

Setting an IntValue

When creating or updating an entity, provide the value in the wrapper:

{
  "Quantity": {
    "value": 50
  }
}

Properties

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.

Common Fields Using IntValue

• Quantity, LineNbr, RowNumber
• Count and sequence fields
• Any whole number field in the API