{"uid":"cap_G2pOktH0RH5f8M36VMBB1","slug":"sebra-taxonomy-by-year-ea3bd77d","name":"SEBRA Taxonomy by Year","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/getTaxonomyForYear?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":["year"],"properties":{"year":{"type":"integer","example":2019,"description":"Calendar year."},"currency":{"type":"string","example":"BGN","description":"BGN or EUR."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"year":2019,"items":[{"category":"Заплати","category_key":"salaries","total_amount":"500000.00"}],"endpoint":"getTaxonomyForYear"}},"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_nXNe5qCFmtE3wS3TKRSQi","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 spending category taxonomy (with totals) from Bulgaria's SEBRA government payment system for a given calendar year","exampleAgentPrompt":"Can you pull the SEBRA government spending category taxonomy for 2019 in EUR so I can see how Bulgaria classified its public payments that year?","exampleUseCases":[{"title":"Bulgarian budget transparency research","prompt":"I'm analyzing Bulgarian public finance — can you get me the full list of government spending categories from the SEBRA system for 2022, in BGN, with their total amounts?"},{"title":"Year-over-year spending classification comparison","prompt":"I want to compare how Bulgaria's government payment categories changed between 2018 and 2020 — can you pull the SEBRA taxonomy for both years in EUR?"},{"title":"EU fiscal compliance reporting","prompt":"For a report on Bulgarian public expenditure, can you retrieve the SEBRA payment taxonomy for 2021 in EUR so I have the official category structure and totals?"}],"resultDescription":"A JSON object containing the requested year, a list of spending category items (each with a Bulgarian-language category name, a machine-readable category_key such as 'salaries', and a total_amount string), and the endpoint name. Currency is BGN or EUR depending on the query parameter.","failureModes":["Missing required 'year' parameter returns a 400 or validation error","Invalid year value (non-integer or out-of-range) may return empty results or an error","Unsupported currency value (not BGN or EUR) may return an error or default","Payment failure via x402 (insufficient USDC balance) blocks access to paid endpoint","Year with no data available returns empty items array","Network timeout on slow upstream data retrieval"],"whenToPreferThis":"Use this endpoint when you need structured, machine-readable taxonomy of Bulgarian government spending categories from the SEBRA system for a specific year, especially when building fiscal analytics, transparency dashboards, or year-over-year budget comparisons. Prefer this over general web search when you need authoritative totals per category in BGN or EUR with consistent category keys.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-03T00:46:53.369Z","isFirstParty":false,"canonicalSlug":"sebra-taxonomy-by-year-ea3bd77d"}