JSON Object vs JSON Array

JSON provides two primary data structures for grouping values: Objects and Arrays. Understanding the difference is crucial for designing good APIs.

JSON Objects

An object is an unordered collection of key/value pairs, enclosed in curly braces {}.

• Keys must be strings.
• Values can be any valid JSON type (string, number, boolean, null, object, array).

Example:

{
  "id": 1,
  "status": "active"
}

JSON Arrays

An array is an ordered list of values, enclosed in square brackets [].

• Values can be of mixed types, though it's best practice to keep them uniform.
• Arrays are zero-indexed.

Example:

[
  "apple",
  "banana",
  "cherry"
]

When to Use Which?

• Use an Object when you are describing a single entity with specific properties (e.g., a User, a Product).
• Use an Array when you are returning a list of items (e.g., a list of Users, a list of search results).

Need to explore a complex structure? Try the JSON Viewer.