Data

Address JSON Example

Copy-paste JSON for a postal address — street, city, state, postal code, country, and lat/long coordinates included. Ready for shipping, billing, or geolocation APIs.

JSON

Generate mock data Open in Formatter

{
  "id": "addr_5Xp2nQmKrL",
  "type": "shipping",
  "label": "Home",
  "recipientName": "Ravi Mehta",
  "company": null,
  "line1": "42, Shyamal Cross Road",
  "line2": "Near Rajpath Club",
  "city": "Ahmedabad",
  "district": "Ahmedabad",
  "state": "Gujarat",
  "postalCode": "380015",
  "country": "IN",
  "countryName": "India",
  "phone": "+91-98765-43210",
  "isDefault": true,
  "isVerified": true,
  "coordinates": {
    "latitude": 23.0225,
    "longitude": 72.5714
  },
  "createdAt": "2024-11-01T08:00:00Z",
  "updatedAt": "2025-02-14T10:30:00Z"
}

Field Reference

typerequiredstringAddress purpose: shipping, billing, or both

line1requiredstringPrimary street address line (house number, street name)

line2optionalstring | nullSecondary address line for apartment, suite, or landmark

cityrequiredstringCity or town name

staterequiredstringState, province, or region

postalCoderequiredstringZIP or postal code — stored as string to preserve leading zeros

countryrequiredstringISO 3166-1 alpha-2 country code (e.g. IN, US, GB)

coordinatesoptionalobjectGeocoded latitude/longitude pair for map display and delivery routing

Variants

MinimalBare address with only required fields — no coordinates or metadata.

Minimal

Generate mock data Open in Formatter

{
  "line1": "15, Vesu Main Road",
  "city": "Surat",
  "state": "Gujarat",
  "postalCode": "395007",
  "country": "IN"
}

ExtendedFull address with verification status, geocoordinates, and delivery instructions.

Extended

Generate mock data Open in Formatter

{
  "id": "addr_5Xp2nQmKrL",
  "type": "shipping",
  "label": "Home",
  "recipientName": "Ravi Mehta",
  "company": "TechCraft Solutions Pvt Ltd",
  "line1": "42, Shyamal Cross Road",
  "line2": "Near Rajpath Club",
  "city": "Ahmedabad",
  "district": "Ahmedabad",
  "state": "Gujarat",
  "postalCode": "380015",
  "country": "IN",
  "countryName": "India",
  "phone": "+91-98765-43210",
  "isDefault": true,
  "isVerified": true,
  "verifiedAt": "2025-01-10T09:00:00Z",
  "coordinates": {
    "latitude": 23.0225,
    "longitude": 72.5714
  },
  "deliveryInstructions": "Ring bell twice. Do not leave with security.",
  "timeZone": "Asia/Kolkata",
  "createdAt": "2024-11-01T08:00:00Z",
  "updatedAt": "2025-02-14T10:30:00Z"
}

Common Use Cases

→Storing and validating shipping and billing addresses at checkout
→Geocoding addresses for last-mile delivery routing and map display
→Pre-filling address forms from a user's saved address book

addresspostalshippinggeolocationlocation

Validate or format this JSON

One click loads this exact example into the tool — no copy-paste needed. Format it, validate it, explore the tree, or generate TypeScript types instantly.

Format Validate Explore tree Generate TypeScript Minify

Frequently Asked Questions

Leading zeros in postal codes (e.g. 01001 in the US) are lost when stored as integers. Always use string type to preserve the exact format.

Multiple structured fields (line1, city, state, postalCode, country) are strongly preferred. A single free-text field is impossible to validate, geocode, or display consistently across countries.

Use ISO 3166-1 alpha-2 codes (IN, US, GB) for machine processing, and optionally include a 'countryName' string for display. Two-letter codes are compact and universally understood.

Related JSON Examples

API DesignUser ProfileStandard user profile JSON with personal info, address, and account metadata.E-commerceE-commerce OrderFull e-commerce order JSON with line items, pricing, shipping, and payment status.DataGeolocationGPS coordinates with accuracy, altitude, speed, and reverse-geocoded address.