API Design

User Profile JSON Example

A complete JSON example for a user profile object — includes name, email, avatar, address, preferences, and role fields. Copy-ready for REST API design and user management systems.

JSON

Generate mock data Open in Formatter

{
  "id": "usr_9k2mXpQr4t",
  "username": "ravi.mehta",
  "email": "ravi.mehta@example.com",
  "fullName": "Ravi Mehta",
  "avatarUrl": "https://cdn.example.com/avatars/usr_9k2mXpQr4t.jpg",
  "phone": "+91-98765-43210",
  "role": "admin",
  "isVerified": true,
  "isActive": true,
  "address": {
    "street": "42, Shyamal Cross Road",
    "city": "Ahmedabad",
    "state": "Gujarat",
    "postalCode": "380015",
    "country": "IN"
  },
  "preferences": {
    "language": "en",
    "timezone": "Asia/Kolkata",
    "newsletterOptIn": true,
    "theme": "dark"
  },
  "createdAt": "2024-03-12T08:45:00Z",
  "updatedAt": "2025-05-01T10:30:00Z",
  "lastLoginAt": "2025-05-20T14:22:00Z"
}

Field Reference

idrequiredstringUnique user identifier with usr_ prefix

usernamerequiredstringLowercase alphanumeric handle, unique per tenant

emailrequiredstringPrimary email address, used for login and notifications

rolerequiredstringAccess control role: admin, editor, or viewer

isVerifiedrequiredbooleanWhether the user has completed email verification

addressoptionalobjectStructured postal address with city, state, and country

preferencesoptionalobjectUser-specific settings such as language, timezone, and theme

createdAtrequiredstring (ISO 8601)Timestamp when the account was first created

Variants

MinimalOnly the required fields needed to create a valid user record.

Minimal

Generate mock data Open in Formatter

{
  "id": "usr_3hFwLmNz8q",
  "username": "priya.sharma",
  "email": "priya.sharma@example.com",
  "fullName": "Priya Sharma",
  "role": "viewer",
  "isVerified": false,
  "isActive": true,
  "createdAt": "2025-04-10T06:00:00Z",
  "updatedAt": "2025-04-10T06:00:00Z"
}

ExtendedFull profile including OAuth connections, two-factor settings, and billing details.

Extended

Generate mock data Open in Formatter

{
  "id": "usr_9k2mXpQr4t",
  "username": "ravi.mehta",
  "email": "ravi.mehta@example.com",
  "fullName": "Ravi Mehta",
  "avatarUrl": "https://cdn.example.com/avatars/usr_9k2mXpQr4t.jpg",
  "phone": "+91-98765-43210",
  "role": "admin",
  "isVerified": true,
  "isActive": true,
  "twoFactorEnabled": true,
  "oauthProviders": [
    "google",
    "github"
  ],
  "address": {
    "street": "42, Shyamal Cross Road",
    "city": "Ahmedabad",
    "state": "Gujarat",
    "postalCode": "380015",
    "country": "IN"
  },
  "preferences": {
    "language": "en",
    "timezone": "Asia/Kolkata",
    "newsletterOptIn": true,
    "theme": "dark"
  },
  "billing": {
    "plan": "pro",
    "renewsAt": "2026-03-12T00:00:00Z",
    "cardLast4": "4242"
  },
  "createdAt": "2024-03-12T08:45:00Z",
  "updatedAt": "2025-05-01T10:30:00Z",
  "lastLoginAt": "2025-05-20T14:22:00Z"
}

Common Use Cases

→Designing the response schema for a GET /users/:id REST endpoint
→Seeding test databases with realistic user fixture data
→Documenting the user object shape in OpenAPI / Swagger specs

userprofileaccountREST APIidentity

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

No. Never include password hashes, salts, or any credential material in a user profile response. Keep auth secrets server-side only.

A prefixed random string like 'usr_9k2mXpQr4t' is human-readable and avoids sequential ID enumeration attacks. UUIDs (e.g. 550e8400-e29b-41d4-a716-446655440000) are also widely used.

Use ISO 8601 UTC strings (e.g. '2025-05-01T10:30:00Z'). This format is unambiguous, timezone-safe, and natively parseable in JavaScript with new Date().

Related JSON Examples

API DesignREST API ResponseGeneric REST API response wrapper with data payload, status, and pagination meta.AuthenticationJWT PayloadJWT payload JSON with standard RFC 7519 claims and custom role/permission fields.API DesignPagination ResponsePaginated list response JSON with offset, cursor, total, and navigation links.