Data Type Reference

​

Primitive Types

​

string

• Text data encoded in UTF-8
• No maximum length restriction
• Empty string "" valid for optional fields
• Null values not allowed

​

number

• Decimal numbers for prices and percentages
• Supports negative values for discounts
• Use for: price, discount_amount, rating_value
• Example: 74999.99, 15.5, -500.00

​

integer

• Whole numbers only
• No decimal places
• Use for: quantities, counts, days
• Example: 5, 100, 0

​

boolean

• true or false only
• No string representations (“true” is invalid)
• Use for: flags and binary states
• Example: true, false

​

Complex Types

​

string (ISO 8601)

• Timestamp format: YYYY-MM-DDTHH:mm:ss±HH:mm
• Include timezone offset
• Example: “2026-02-05T13:20:30+05:30”
• Use for: timestamp, order_date, estimated_delivery_date

​

array

• Ordered collection of objects
• JSON array format
• Use for: products, filters
• Example: [{"product_id": "123"}, {"product_id": "456"}]

​

object

• Key-value pairs
• Nested structure allowed
• Use for: addresses, nested data
• Example: {"first_name": "Rajesh", "last_name": "Kumar"}

​

Currency Codes (ISO 4217)