1Overview

The UnsignedShort scalar type represents an unsigned 16-bit integer. It is intended for scenarios where values are constrained to the range 0 to 65,535, such as representing port numbers, small counts, or other non-negative values that fit within 16 bits.

Unlike the Short scalar which represents signed 16-bit integers with a range of -32,768 to 32,767, UnsignedShort 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 UnsignedShort.

3Result spec

An UnsignedShort scalar must serialize to an integer value in the range 0 to 65,535 (inclusive).

4Input spec

An UnsignedShort scalar accepts integer values in the range 0 to 65,535 (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 65,535 (inclusive)
• Value is not negative

query {
  serviceStatus(port: 8080) {
    status
  }
}

{
  "port": 8080
}

{
  "maxConnections": 65535
}

5References

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