# DataNexusAI SEBRA Taxonomy for Year

> DataNexusAI SEBRA Taxonomy for Year 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 SEBRA payment taxonomy (classification hierarchy) for a specified calendar year, optionally in BGN or EUR currency.

## Facts

- Endpoint: GET https://api.datanexusai.org/api/sebra/getTaxonomyForYear/%7Byear%7D?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/datanexusai-sebra-taxonomy-for-year-ab20855d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kRW1iVNGiGcQ95JMGsu0Y

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 datanexusai-sebra-taxonomy-for-year-ab20855d
```

Example prompt: Can you pull the SEBRA payment taxonomy for 2019 in EUR so I can see how Bulgarian government spending was classified that year?

## When to prefer this

Use this endpoint when you need the official SEBRA payment classification hierarchy for a specific calendar year, particularly for Bulgarian public finance research, fiscal data enrichment, or government budget analytics. Prefer this over general budget data endpoints when you specifically need the taxonomy/classification structure rather than raw transaction data.

## Known failure modes

- Invalid or unsupported year returns a 400 or 404 error
- Invalid currency code (not BGN or EUR) returns a validation error
- Payment required (402) if USDC micropayment is not provided
- Year with no available taxonomy data returns empty or not-found response
- Network timeout for slow upstream data source

## 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 structured taxonomy (classification hierarchy) of SEBRA payment categories for the requested calendar year, with values expressed in the requested currency (BGN or EUR). Includes budget codes, category labels, and hierarchical groupings used by the Bulgarian State Treasury.

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "year"
     ],
     "properties": {
      "year": {
       "type": "integer",
       "example": 2019,
       "description": "Calendar year."
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "currency": {
       "type": "string",
       "example": "BGN",
       "description": "BGN or EUR."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/datanexusai-sebra-taxonomy-for-year-ab20855d/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)