# Agent402 Locale Brief

> Agent402 Locale Brief is a paid API for AI agents from agent402.tools, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-13).

Returns a bundled country snapshot for scheduling counterparty reachability: country facts, this year's public holidays, working days remaining this week, and current local time — in one paid call.

## Facts

- Endpoint: POST https://agent402.tools/api/skill/locale-brief
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-locale-brief-1222fb79
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UYTqEn2dh2Qlx3UR5mYrQ

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 agent402-locale-brief-1222fb79 -d '<json body>'
```

Example prompt: Can I realistically reach my counterpart in Japan this week — give me a quick brief with their public holidays, how many working days are left, and what time it is there right now.

## When to prefer this

Choose this endpoint when you need a quick, pre-trip or pre-call scheduling brief for a specific country and want country facts, holidays, working days, and local time in one atomic call rather than stitching together four separate API calls. Ideal for AI agents handling international scheduling, counterparty reachability checks, or travel/business planning workflows where cost efficiency (one x402 payment for four data points) matters.

## Known failure modes

- Unrecognized country name returns an error — use full official country name (e.g. 'United States' not 'USA')
- Holiday data may be incomplete for countries with limited public data coverage
- Time zone ambiguity for large countries with multiple zones (e.g. Russia, USA) may return the capital's zone
- Payment failure or insufficient USDC balance returns 402 Payment Required
- Network timeout returns 5xx error

## How this service works

Bundled execution of the Locale brief workflow - "Can I reach this counterparty this week?" - country facts, this year's public holidays, working days remaining this week, and what time it is there right now, in one call. One x402 payment runs 4 underlying tools (country-info, public-holidays, business-days, timezone-convert); partial-success per step.

## Output

A bundled JSON response containing: basic country facts, a list of this year's public holidays for the specified country, the number of working days remaining in the current week, and the current local time in that country — all in a single response for one $0.05 USDC x402 payment.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "country": {
   "type": "string",
   "description": "Country name (e.g. Japan, Germany, Brazil)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "args": {
   "country": "Japan"
  },
  "pack": "locale-brief",
  "steps": [
   {
    "ok": true,
    "slug": "country-info",
    "result": {}
   },
   {
    "ok": true,
    "slug": "public-holidays",
    "result": {}
   },
   {
    "ok": true,
    "slug": "business-days",
    "result": {}
   },
   {
    "ok": true,
    "slug": "timezone-convert",
    "result": {}
   }
  ],
  "summary": "4/4 steps succeeded"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-locale-brief-1222fb79/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)
