1Overview

The UnsignedInt scalar type represents an unsigned 32-bit integer. It is intended for scenarios where values are constrained to the range 0 to 4,294,967,295, such as representing counts, sizes, indices, or other non-negative integer values.

Unlike the built-in Int scalar which represents signed 32-bit integers with a range of -2,147,483,648 to 2,147,483,647, UnsignedInt provides stronger type safety for values that must be non-negative and can represent larger positive values.

2Recommended name

The recommended name for this scalar is UnsignedInt.

3Result spec

An UnsignedInt scalar must serialize to an integer value in the range 0 to 4,294,967,295 (inclusive).

4Input spec

An UnsignedInt scalar accepts integer values in the range 0 to 4,294,967,295 (inclusive), both as GraphQL literals and as JSON input values.

Implementations should validate:

• Value is an integer (no fractional component)
• Value is between 0 and 4,294,967,295 (inclusive)
• Value is not negative

query {
  items(limit: 100, offset: 50) {
    id
  }
}

{
  "limit": 100,
  "offset": 50
}

{
  "count": 4294967295
}

5References

• GraphQL Specification – Int — Built-in integer scalar type