Overview
The Milestones API allows you to track your baby’s developmental achievements. Milestones can be predefined (based on age-appropriate development) or custom (created by caregivers).Milestone Schema
List Milestones
Retrieve all milestones for a baby profile.Parameters
The baby profile ID
Response
Array of milestone objects
Mark Milestone Achieved
Mark a predefined milestone as achieved.Parameters
The baby profile ID
Unique milestone key (e.g., “first_smile”, “sits_unsupported”)
Milestone title (e.g., “First Social Smile”)
Category: “motor”, “language”, “social”, or “cognitive”
ISO 8601 timestamp when achieved. Defaults to current time if omitted.
Optional note about the milestone
Array of photo IDs to attach
Array of video IDs to attach
Response
The milestone ID (creates new or updates existing)
If a milestone with the same
key already exists for this baby, it will be updated instead of creating a duplicate.Create Custom Milestone
Create a custom milestone unique to your baby.Parameters
The baby profile ID
Custom milestone title
Category: “motor”, “language”, “social”, or “cognitive”
Achievement timestamp (defaults to now)
Optional note
Photo attachments
Video attachments
Response
The newly created custom milestone ID
Custom milestones are automatically assigned a unique key (e.g.,
custom_1709654400_abc123) and marked with isCustom: true.Update Milestone
Update an existing milestone’s details.Parameters
The milestone ID to update
Updated achievement date
Updated note
Updated photo IDs (replaces existing)
Updated video IDs (replaces existing)
Delete Milestone
Delete a milestone permanently.Parameters
The milestone ID to delete
Milestone Categories
Motor
Physical development milestones:
- Rolling over
- Sitting unsupported
- Crawling
- Walking
- Fine motor skills (grasping, pincer grip)
Language
Communication milestones:
- Cooing and babbling
- First words
- Two-word phrases
- Sentence formation
- Understanding commands
Social
Social and emotional development:
- Social smiles
- Recognizing caregivers
- Playing with others
- Sharing and turn-taking
- Expressing emotions
Cognitive
Mental development milestones:
- Object permanence
- Cause and effect
- Problem solving
- Memory skills
- Sorting and categorizing
Common Predefined Milestones
0-3 Months
first_smile- First Social Smiletracks_objects- Tracks Moving Objectslifts_head- Lifts Head When on Tummycoos- Makes Cooing Sounds
4-6 Months
rolls_over- Rolls Over Both Wayssits_with_support- Sits With Supportreaches_for_toys- Reaches for Toysbabbles- Babbles with Consonants
7-9 Months
sits_unsupported- Sits Without Supportcrawls- Crawls or Scootstransfers_objects- Transfers Objects Between Handsresponds_to_name- Responds to Name
10-12 Months
stands_with_support- Stands With Supportfirst_steps- Takes First Stepsfirst_word- Says First Wordwaves_bye- Waves Bye-Bye
Age ranges are approximate. Every baby develops at their own pace. Consult your pediatrician if you have concerns.
Best Practices
Record milestones promptly
Record milestones promptly
Capture achievements when they happen. Use the
achievedAt field to backdate if needed.Add photos and videos
Add photos and videos
Visual memories make milestone tracking more meaningful. Attach photos and videos to preserve these moments.
Include context in notes
Include context in notes
Add details like who was there, what happened, or the baby’s reaction to make memories richer.
Use custom milestones
Use custom milestones
Don’t limit yourself to predefined milestones. Create custom ones for unique achievements like “First time at the beach” or “Met cousin for first time”.
Track across categories
Track across categories
Babies develop in multiple areas simultaneously. Track motor, language, social, and cognitive milestones for a complete picture.
Related Resources
Milestones Guide
Feature guide and tracking tips
Baby Profiles
Baby profile management
Events
Track daily activities
Media Upload
Learn about photo and video attachments
