Plan of Day
API Reference

// Create a daily field report
const response = await fetch('https://api.planofday.com/v1/reports', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer pod_live_sk_...',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    project_id: 'proj_abc123',
    date: '2026-02-15',
    weather: { temp: 42, conditions: 'Clear', wind: 8 },
    manpower: [
      { trade: 'Electricians', count: 12, hours: 8 },
      { trade: 'Pipefitters', count: 8, hours: 10 }
    ],
    safety: {
      incidents: 0,
      near_misses: 1,
      toolbox_talk: 'Ladder Safety'
    },
    notes: 'Completed conduit run on Level 3.'
  })
});

const report = await response.json();
// => { id: "rpt_xyz", status: "created", kpis: { ... } }

// Get project KPIs
const kpis = await fetch(
  'https://api.planofday.com/v1/projects/proj_abc123/kpis',
  {
    headers: {
      'Authorization': 'Bearer pod_live_sk_...'
    }
  }
).then(r => r.json());

// => {
//   emr: { value: 0.82, status: "excellent", trend: "improving" },
//   trir: { value: 1.4, status: "good", trend: "stable" },
//   schedule_variance: { value: -2, unit: "days", status: "on_track" },
//   cost_performance_index: { value: 1.03, status: "good" },
//   manpower_total: { value: 847, trend: "increasing" },
//   ...148 more KPIs
// }

// Register a webhook
await fetch('https://api.planofday.com/v1/webhooks', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer pod_live_sk_...',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://your-app.com/webhooks/pod',
    events: ['report.created', 'kpi.threshold_breach'],
    secret: 'whsec_your_signing_secret'
  })
});

// Incoming webhook payload:
// {
//   event: "kpi.threshold_breach",
//   timestamp: "2026-02-15T14:30:00Z",
//   data: {
//     project_id: "proj_abc123",
//     kpi: "trir",
//     value: 2.8,
//     threshold: 2.5,
//     severity: "warning"
//   }
// }