# Drillr Fiscal Period Utility

> Drillr Fiscal Period Utility is a paid API for AI agents from gateway.drillr.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Resolves fiscal period metadata and calendar mappings for a given company ticker, calendar month, fiscal year, or fiscal quarter

## Facts

- Endpoint: POST https://gateway.drillr.ai/api/x402/data/fiscal_utility
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/drillr-fiscal-period-utility-ac536f84
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pnhvbNW3WJK8Q4wEdZbQR

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 drillr-fiscal-period-utility-ac536f84 -d '<json body>'
```

Example prompt: What fiscal quarter and year does the calendar month 2024-03 fall into for Apple (AAPL), and what are the start and end dates of that fiscal period?

## When to prefer this

Use this endpoint when you need to map calendar dates to a specific company's fiscal reporting periods, or vice versa. Ideal for financial analysis workflows where you need to align economic data, earnings, or events to the correct fiscal quarter or year for a given public company. Prefer this over generic date utilities when company-specific fiscal calendars (which often differ from calendar years) are required.

## Known failure modes

- Unknown or invalid ticker returns error or empty result
- Invalid yyyy_mm format (not matching YYYY-MM pattern) returns validation error
- Fiscal quarter integer outside 1-4 range returns validation error
- Fiscal year outside 1900-2100 range returns validation error
- Company with non-standard or untracked fiscal calendar may return incomplete data
- Missing all optional fields with no resolvable context may return ambiguous or null result

## How this service works

Fiscal period / calendar utility for financial reports

## Output

Returns fiscal period metadata for the queried company and time reference, including fiscal year, fiscal quarter number, and likely the start/end dates of the corresponding fiscal reporting period, mapped from the provided calendar month or fiscal year/quarter inputs.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ticker": {
   "type": "string"
  },
  "yyyy_mm": {
   "type": "string",
   "pattern": "^\\d{4}-\\d{2}$"
  },
  "fiscal_year": {
   "type": "integer",
   "maximum": 2100,
   "minimum": 1900
  },
  "fiscal_quarter": {
   "type": "integer",
   "maximum": 4,
   "minimum": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/drillr-fiscal-period-utility-ac536f84/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.drillr.ai](https://www.zero.xyz/host/gateway.drillr.ai/llms.txt)