Goals

URL identifier for the goal; can change over time, use Id for stable references

User-specified display name for the goal as shown in the Beeminder interface

Current urgency based on safety buffer: green (3+ days safe), blue (2 days), orange (1 day), red (beemergency)

The allowed values are green, blue, orange, red.

Unix timestamp when the bright red line starts and goal tracking began

Unix timestamp of last modification to goal settings or road configuration

Target value to reach by goaldate; null if calculated from rate and goaldate (exactly one of goalval/rate/goaldate is null)

Slope of the bright red line representing required progress rate; null if calculated from goalval and goaldate

Unix timestamp when goal reaches goalval; null if calculated from rate and goalval (commitment contract requires exactly 2 of 3 parameters)

URL to vector graphics (SVG) version of the goal progress graph for high-quality displays

URL to PNG raster image of the goal progress graph

URL to small thumbnail preview image of the goal graph for quick visual reference

Goal behavior type: hustler (do more), biker (odometer), fatloser (lose weight), gainer (gain weight), inboxer (inbox zero), drinker (do less), or custom

Name of automatic data integration source (e.g., 'fitbit', 'github', 'rescuetime'); null for manually tracked goals

Apple HealthKit metric name being auto-tracked (e.g., 'steps', 'exercise_time') when iOS integration is enabled

JSON object containing configuration settings for the automatic data integration

Unix timestamp when the goal will derail if no progress is made; the beemergency deadline

Composite sorting key for ordering goals by urgency combining safety buffer days, goal importance, and other factors for dashboard prioritization

Seconds after midnight (00:00) when the Beeminder day ends and datapoints are due; defaults to 6am (21600 seconds)

Seconds before the deadline when reminders start being sent; use 0 for reminders at deadline, or higher values like 86400 for 24-hour advance notice

Seconds before the deadline when alert notifications begin; typically less than leadtime for escalating urgency

True if this goal uses the user's account-level default settings for deadline and reminder times; false for custom per-goal settings

Permanent unique identifier (hex string) for the goal; preferred over slug which can change

True if this is an ephemeral test goal that will be automatically deleted after a period; used for API testing and experimentation

True if road dial changes are queued and waiting to take effect after the one-week akrasia horizon delay

Seconds before deadline when panic mode activates; typically 86400 (24 hours) to trigger emergency notifications and increased urgency display

Goal priority level: 'frontburner' for active focus goals, 'backburner' for maintenance mode with minimal effort

The allowed values are frontburner, backburner.

Which side of bright red line is good: +1 (above line is good/yay), -1 (below line is good); combined with dir determines goal type

Current distance from the bright red line in goal units; positive means safe above the line, negative means derailed below the line

Rate units for displaying slope: 'y'(yearly), 'm'(monthly), 'w'(weekly), 'd'(daily), or 'h'(hourly); combined with gunits to form readable rate like '5 pages per day'

Human-readable summary of maximum daily rate limit for do-less goals (e.g., 'at most 5 cigarettes per day')

True if goal is frozen (stopped/paused with bright red line flattened); no derailment risk but also no progress required until restarted

True if goal has derailed (crossed to wrong side of bright red line); triggers pledge charge and commitment contract consequences

True if goal was successfully completed by reaching the goalval at or before goaldate; archived victorious goal

Commitment contract object containing pledge amounts and stepdown schedule for the accountability system

Current pledge amount in USD at stake; charged to payment method on next derailment

Unix timestamp when pledge will automatically decrease to previous level after sustained success without derailments

New pledge amount waiting to take effect after the akrasia horizon (7-day anti-backsliding delay); null if no change pending

Unix timestamp when the pending pledge change will become the active contract amount; null if no change queued

Human-readable description of current position relative to bright red line with units (e.g., '2.5 pushups to the good', '1.2 pounds over the line')

Number of safe days of buffer; 0 means beemergency (must report progress today to avoid derailment); negative means already derailed

Amount of progress needed today (in goal units) to gain one additional day of safety buffer; the incremental cost of extra safety

Human-readable safety buffer summary combining safebuf with context (e.g., 'safe for 3 more days', 'due in 18 hours')

Maximum safety buffer days allowed; road automatically ratchets closer when exceeded to prevent excessive cushion and maintain commitment pressure

True if goal has a flat bright red line (rate=0); maintaining current level without required increase or decrease

Human-readable summary showing absolute calendar date when rate-limited goals become unrestricted (e.g., 'at most 5/day til Dec 31')

Human-readable summary showing relative days until rate limit expires (e.g., 'at most 5/day for 12 more days')

Bare minimum progress required today to avoid derailment; the absolute least you must do before deadline to stay on the right side of red line

Total cumulative value required by end of day to stay on track; different from baremin for cumulative (kyoom) goals

Color-coded urgency indicator: green (3+ safe days), blue (2 days), orange (1 day), red (beemergency - due today)

The allowed values are green, blue, orange, red.

ISO 8601 timestamp of last interaction; updated when goal settings changed or datapoints added; used for sorting recently active goals

True if goal accepts only integer values with no decimal places (e.g., counting discrete items like pages or workouts)

User-specified commitment contract description defining the rules, terms, and conditions for this goal; displayed with pledge information

True if task is available to complete today for IFTTT/Zapier 'Do Today' trigger; helps external automation tools identify actionable goals

True if goal tracks time duration; datapoint values interpreted as seconds and displayed in HH:MM:SS format

Goal units name for measurements (e.g., 'hours', 'pages', 'pushups', 'pounds'); displayed on graph y-axis and in progress descriptions

True if bright red line flattens on Saturdays and Sundays; no progress required on weekends but weekdays maintain the specified rate

Label for vertical axis on the goal graph; typically combines curval description with gunits (e.g., 'Total pages read')

Maximum allowed daily fluctuation for noisy data goals like weight; Beeminder smooths/averages values within this range to find the true trend

Unix timestamp of earliest datapoint; marks beginning of actual data history (may be after initday if no data entered initially)

Unix timestamp of most recent datapoint; marks the current edge of recorded data

Unix timestamp when bright red line starts; the origin point (t=0) where the road begins, equals tmin for goals with initial data

Starting y-axis value where bright red line begins; the baseline from which progress is measured

Unix timestamp of current Beeminder day; the 'today' for this goal considering the custom deadline time

Current cumulative value as of most recent datapoint; total progress achieved so far for kyoom goals, or latest value for non-kyoom

Current rate of progress calculated from recent data trend; may differ from goal rate, showing actual performance vs. commitment

Unix timestamp of last day with an explicitly entered datapoint; different from tmax which includes auto-generated or inferred points

Bright red line direction: +1 for upward slope (increase over time), -1 for downward slope (decrease over time); combined with yaw determines goal type semantics

True if goal uses cumulative tracking; datapoints are summed together (like total pages read); false means latest value only (like current weight)

Odometer reading for distance/count goals; cumulative total that continues counting even when datapoint resets to zero (treats zeros as accidental resets, not true zero)

True if data has high variance requiring smoothing, typically weight-tracking goals where daily fluctuations don't reflect true trend, triggers moving average calculations

Aggregation method for multiple datapoints on same day: 'sum' (add all), 'last' (most recent), 'max' (highest), 'min' (lowest), 'mean' (average)

The allowed values are sum, last, max, min, mean.

True to plot all individual datapoints on graph; false to plot only daily aggregated values; useful for visualizing intra-day patterns

True for step function graph display with flat horizontal segments between datapoints; false for linear interpolation connecting points with diagonal lines

True for optimistic aggregation taking the best datapoint of each day (furthest in good direction); false uses aggday setting; helps visualize best-case performance

True to display exponentially-weighted moving average line on graph for smoothing noisy data; helps identify underlying trend through daily variance

True to show aura visualization with colored background regions on graph indicating safety zones; visual urgency indicator with green/blue/orange/red bands

Total count of datapoints submitted for this goal; includes all entries even if later deleted or modified

Array of [time, value, rate] tuples defining bright red line segments; the core commitment schedule

Complete road array including initial row [initday, initval, null] and final row; adds endpoints to road

Roadall with all nulls filled in; computed values for goaldate, goalval, and rate in every segment

True if goal is private requiring login to view; hidden from public gallery; false means publicly visible on Beeminder.com

Current stake amount in USD charged to payment method on next derailment; escalates exponentially after each failure

Maximum pledge cap in USD; prevents pledge from escalating beyond this amount regardless of derailment count

Array with all three parameters [goaldate, goalval, rate] filled in for verification; Beeminder computes the third parameter from the given two

True if datapoints are publicly viewable; false requires login to see data; independent of secret setting which controls goal visibility

Red line value at the akrasia horizon (7 days ahead); shows where commitment line will be after the anti-backsliding delay period

Most recent datapoint object with timestamp, value, comment; quick access without fetching all datapoints

Webhook URL for notifications; Beeminder POSTs to this URL when datapoints added or goal status changes; enables integrations and custom monitoring

Array of user-defined alphanumeric tags for categorizing and filtering goals; used for dashboard organization

Array of recent datapoints included in goal object; preview of latest progress without separate API call

Object mapping future dates to required cumulative values; shows upcoming progress milestones and deadlines

Beeminder account username; required for API authentication to access user's goals

Set true when querying single goal to include complete datapoints array in response; adds all historical data entries with timestamps and values

Set true to exclude road, roadall, and fullroad arrays from response; significantly reduces payload size for bandwidth-constrained applications