{"uid":"cap_9k69I_f6zJ45D9t9mqmHz","slug":"sebra-payments-get-periods-with-most-payments-05697772","name":"SEBRA Payments - Get Periods With Most Payments","description":"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.\n\nMachine-readable discovery: `https://api.datanexusai.org/openapi.json`, `https://api.datanexusai.org/llms.txt`, `https://api.datanexusai.org/.well-known/x402`.\n\nHuman docs: `/docs` and `/api/`.","url":"https://api.datanexusai.org/api/sebra/getPeriodsWithMostPayments?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"day_of_month":28,"total_amount":"1234567.89","payment_count":42}],"period":"days","endpoint":"getPeriodsWithMostPayments"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6Jphr1EbsblBGDJp-HyHk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Peak payment day analysis for fiscal planning","prompt":"Show me the top 10 days of the month with the highest total SEBRA payment amounts in EUR for the full year 2023."},{"title":"Weekday spending pattern research","prompt":"Which weekdays see the most Bulgarian government SEBRA payments by total amount? Give me a full ranking across all weekdays for 2022."},{"title":"Monthly budget disbursement trends","prompt":"What were the top 5 months by payment count in the SEBRA system between January 2020 and December 2021, in BGN?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-03T00:45:24.828Z","isFirstParty":false,"canonicalSlug":"sebra-payments-get-periods-with-most-payments-05697772"}