# SEBRA Payments - Get Periods With Most Payments

> SEBRA Payments - Get Periods With Most Payments is a paid API for AI agents from api.datanexusai.org, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-03).

Returns the days, months, or weekdays with the highest total payment amounts or counts from Bulgarian SEBRA government payment data, optionally filtered by date range, year, and currency.

## Facts

- Endpoint: GET https://api.datanexusai.org/api/sebra/getPeriodsWithMostPayments?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-03
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sebra-payments-get-periods-with-most-payments-05697772
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9k69I_f6zJ45D9t9mqmHz

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 sebra-payments-get-periods-with-most-payments-05697772
```

Example prompt: Which days of the month had the highest total payment amounts in the Bulgarian SEBRA system during 2024, broken down by days and in EUR — give me the top 10?

## When to prefer this

Use this endpoint when you need to identify peak payment periods (by day, month, or weekday) in Bulgarian government SEBRA data, ranked by volume or amount. It is purpose-built for temporal aggregation and ranking, making it ideal for fiscal pattern analysis, budget cycle research, or government spending trend detection — as opposed to retrieving raw individual transactions or non-temporal aggregations.

## Known failure modes

- Missing required 'period' query parameter returns a validation error
- Invalid date format (not DD-MM-YYYY or MM-YYYY) causes a 400 error
- Unsupported currency code (not BGN or EUR) may return empty results or an error
- Payment required (402) if USDC micropayment via x402 is not provided
- Date range with no matching SEBRA data returns empty items array
- Limit value of 0 or negative may cause unexpected behavior

## How this service works

Public data API for SEBRA payments, PTP road accidents, Hearthstone cards, EU agri-food prices, and trade/market analytics. Paid data endpoints use x402 (USDC micropayments). Docs and discovery endpoints are free.

Machine-readable discovery: `https://api.datanexusai.org/openapi.json`, `https://api.datanexusai.org/llms.txt`, `https://api.datanexusai.org/.well-known/x402`.

Human docs: `/docs` and `/api/`.

## Output

A JSON object containing a ranked list of periods (days of month, calendar months, or weekdays) with their total payment amounts and payment counts, plus metadata indicating the period type and total row count returned.

## 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",
     "required": [
      "period"
     ],
     "properties": {
      "to": {
       "type": "string",
       "example": "01-11-2020",
       "description": "Inclusive end (DD-MM-YYYY or MM-YYYY)."
      },
      "from": {
       "type": "string",
       "example": "01-10-2020",
       "description": "Inclusive start (DD-MM-YYYY or MM-YYYY)."
      },
      "year": {
       "type": "integer",
       "example": 2024,
       "description": "Restrict to one calendar year."
      },
      "limit": {
       "type": "integer",
       "example": 10,
       "description": "Max rows after sorting by amount."
      },
      "period": {
       "enum": [
        "days",
        "months",
        "weekdays"
       ],
       "type": "string",
       "example": "days",
       "description": "One of: days, months, weekdays. Or pass as flag ?days / ?months / ?weekdays."
      },
      "currency": {
       "type": "string",
       "example": "EUR",
       "description": "BGN or EUR. Omit to group by currency."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "day_of_month": 28,
    "total_amount": "1234567.89",
    "payment_count": 42
   }
  ],
  "period": "days",
  "endpoint": "getPeriodsWithMostPayments"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sebra-payments-get-periods-with-most-payments-05697772/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.datanexusai.org](https://www.zero.xyz/host/api.datanexusai.org/llms.txt)