Skip to content
Module
Tech

What is JSON? Definition and use in products

JSON (JavaScript Object Notation) is a text format that represents structured data with key-value pairs and lists. It supports a few simple types: strings, numbers, booleans, the null value, objects in curly braces and arrays in square brackets. Readable by people and easy for machines to parse, it has become the default exchange format for web APIs.

Definition written by Alex Dionisio, Senior Product Manager. Updated November 13, 2026.

Why it matters for a PM

API responses, webhook payloads, configuration files, analytics events and structured LLM outputs are most often written in JSON. A PM who can read it checks what an API actually returns, spots a missing or mistyped field and writes precise examples in a spec. That saves round trips with the engineering team.

Example

While testing a shipping API, a PM notices in the JSON response that the delivery_date field is null for parcels sent to pickup points. The spec planned to show that date everywhere, so the PM adds a case for that status with fallback text before development starts.

Key points

  • An object groups key-value pairs; an array holds an ordered list of values.
  • JSON has no date type: dates travel as strings, often in ISO 8601 format.
  • A JSON Schema describes the expected shape of the data and allows automatic validation.
  • One extra comma or a missing quote is enough to make a document unreadable for a machine.

Common mistakes

  • Assuming a field is always present when the API may omit it or return null.
  • Mixing up the number 10 and the string “10”, which breaks sorting and math.
  • Hand-writing spec examples without checking that they are valid JSON.

Go further with Module

The courses and lessons that cover this concept:

Guides on this topic