# Taxon Synonym Graph Builder

> Taxon Synonym Graph Builder is a paid API for AI agents from natur.halowerk.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-14).

Assembles a cross-register synonym graph for a taxon, comparing GBIF and WoRMS name treatments to reveal disagreements in accepted/synonym/species status

## Facts

- Endpoint: POST https://natur.halowerk.com/v1/synonym-graph
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/taxon-synonym-graph-builder-a9add664
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_etaHLIoZN5yOrMwBpCy8c

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 taxon-synonym-graph-builder-a9add664 -d '<json body>'
```

Example prompt: Build a synonym graph for Acacia dealbata — I need all the synonyms, basionyms, and alternate names with their authorities and statuses from both GBIF and WoRMS, and flag any cases where the two registers disagree on whether something is a synonym or a separate species.

## When to prefer this

Choose this endpoint when you need to reconcile taxonomic names across multiple biodiversity registers simultaneously, especially when the disagreement between GBIF and WoRMS is itself the research question. It is superior to querying either register alone when building authoritative synonym lists, merging heterogeneous biodiversity datasets, or auditing nomenclatural status for publications or conservation work.

## Known failure modes

- Taxon name not found in either GBIF or WoRMS — returns empty or minimal graph
- Ambiguous name matching multiple taxa — may require a more specific identifier
- Register query timeout — partial graph returned with one register's data missing
- Name spelling errors causing no-match — returns error indicating unresolved name
- Rate limit exceeded — HTTP 429 response

## How this service works

Assembles all names associated with one taxon into a graph with the accepted name at the centre and every synonym, basionym and alternate representation as a node carrying its status, authority and the register that supplied it. Two registers are queried rather than one because their disagreement is the finding: reconciling datasets that span decades regularly turns up names that GBIF treats as a synonym and WoRMS treats as a separate species, or the reverse, and a service that silently follows…

## Output

A graph structure centred on the accepted name for the queried taxon, with nodes for every synonym, basionym, and alternate name representation. Each node carries its nomenclatural status, authority string, and the register (GBIF or WoRMS) that supplied it. Disagreements between registers — where one treats a name as a synonym and the other as a valid species — are surfaced explicitly.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "maxLength": 200,
   "minLength": 2
  },
  "include_worms": {
   "type": "boolean",
   "default": true,
   "description": "Query WoRMS as well. Only meaningful for marine taxa but harmless otherwise."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/taxon-synonym-graph-builder-a9add664/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from natur.halowerk.com](https://www.zero.xyz/host/natur.halowerk.com/llms.txt)