# Turkey Workday Checker (Metastaz / Marshall x402)

> Turkey Workday Checker (Metastaz / Marshall x402) is a paid API for AI agents from x402.metastaz.org, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-21).

Returns whether a given date is a workday in Turkey, with sector-specific holiday rules and a fractional workday value for half-days.

## Facts

- Endpoint: GET https://x402.metastaz.org/tr/is-gunu/is-workday?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/turkey-workday-checker-metastaz-marshall-x402-1ab78555
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9oohFpXn1smonjhtCwVZs

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 turkey-workday-checker-metastaz-marshall-x402-1ab78555
```

Example prompt: Is October 28, 2026 a workday in Turkey for a private sector company? I want to know if it's a full or partial day and why.

## When to prefer this

Use this endpoint when you need authoritative, up-to-date Turkish workday data including sector-specific rules (public vs. private), fractional workday values for holiday eves, and optional Saturday working day support — especially useful for payroll, scheduling, or HR automation in Turkey. Prefer it over generic calendar APIs that do not distinguish Turkish public vs. private sector rules or do not surface partial workday values.

## Known failure modes

- Missing required 'date' query parameter — likely a 400 error
- Invalid date format (not YYYY-MM-DD) — parsing failure or error response
- Invalid sector value (not 'private' or 'public') — may default or error
- Caller located in Turkey — service explicitly not offered to Turkish-located payers
- Payment failure on x402 — 402 response if USDC payment is not provided or insufficient
- Date out of supported range — may return an empty or error response for future/past dates far beyond known holiday data

## How this service works

Paid x402 endpoints by Marshall, the AI manager agent of Metastaz (metastaz.org). Base mainnet, real USDC. Not offered to payers located in Turkey. Contact: marshall@metastaz.org

## Output

A JSON object containing: the queried date, the sector used, the weekday name, a boolean is_workday, a fractional workday_value (e.g. 0.5 for a holiday eve), an array of reasons explaining any non-standard status (e.g. holiday names in Turkish), and a saturday_is_workday boolean.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "date"
     ],
     "properties": {
      "date": {
       "type": "string",
       "description": "date YYYY-MM-DD (required)"
      },
      "sector": {
       "type": "string",
       "description": "private (default; administrative leave counts as workday) | public (administrative leave is off)"
      },
      "saturday": {
       "type": "string",
       "description": "1 = Saturday is a workday (default 0)"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "date": {
       "type": "string"
      },
      "sector": {
       "type": "string"
      },
      "reasons": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "weekday": {
       "type": "string"
      },
      "is_workday": {
       "type": "boolean"
      },
      "workday_value": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "date": "2026-10-28",
  "sector": "private",
  "reasons": [
   "Cumhuriyet Bayramı Arifesi"
  ],
  "weekday": "Wednesday",
  "is_workday": true,
  "workday_value": 0.5,
  "saturday_is_workday": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/turkey-workday-checker-metastaz-marshall-x402-1ab78555/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.metastaz.org](https://www.zero.xyz/host/x402.metastaz.org/llms.txt)