# ZenSched Timesheet Status

> ZenSched Timesheet Status is a paid API for AI agents from mcp.zensched.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-21).

Returns shift-pair timesheet status for a given period, including completeness, hours worked, GPS data, approval/lock flags, and pending edits.

## Facts

- Endpoint: GET https://mcp.zensched.com/x402/tools/timesheet_status?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zensched-timesheet-status-8430aa2b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WhlkhGgEBrrYuKVhbkkQ0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability zensched-timesheet-status-8430aa2b
```

Example prompt: Pull the ZenSched timesheet status for the current payroll window for worker ID 42, using approval level 1, and tell me which shifts are still open or have pending edits.

## When to prefer this

Use this endpoint when you need to audit timesheet completeness, check GPS and hours data, or verify approval and lock status for one or more workers over a specific pay period. Prefer this over general scheduling endpoints when your focus is payroll readiness, timesheet approval workflows, or detecting pending edits before payroll close.

## Known failure modes

- Invalid period format returns an error (must be YYYY-MM, YYYY-MM-DD:YYYY-MM-DD, 'current', or blank)
- Unknown worker_id or event_id returns empty results or 404
- Insufficient prepaid USDC balance causes payment failure and no data returned
- Malformed worker_ids_json string causes a parsing error
- Requesting approval level outside 0-2 may return a validation error

## How this service works

ZenSched `timesheet_status` — Shift-pair timesheet status for a period: complete/open, hours, GPS, approval/lock flags, pending edits. period: YYYY-MM, YYYY-MM-DD:YYYY-MM-DD, current (payroll window), or blank (calendar month). Optional worker_id, worker_ids_json, event_id. level: 0/1/2 vendor approval level (default 0 = approved_0). Pay-per-call $0.01 USDC; the paying wallet owns the org (auto-provisioned on first call). Catalog: https://mcp.zensched.com/x402/tools

## Output

Returns a structured object for each shift pair in the requested period, including open/complete status, total hours, GPS verification data, approval and lock flags at the requested vendor level, and any pending edits awaiting resolution.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "title": "timesheet_statusArguments",
     "properties": {
      "level": {
       "type": "integer",
       "title": "Level",
       "default": 0
      },
      "period": {
       "type": "string",
       "title": "Period",
       "default": ""
      },
      "event_id": {
       "type": "integer",
       "title": "Event Id",
       "default": 0
      },
      "worker_id": {
       "type": "integer",
       "title": "Worker Id",
       "default": 0
      },
      "worker_ids_json": {
       "type": "string",
       "title": "Worker Ids Json",
       "default": ""
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zensched-timesheet-status-8430aa2b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.zensched.com](https://www.zero.xyz/host/mcp.zensched.com/llms.txt)