{"uid":"cap_9QyCy-ewQMMUF27xJFcT_","slug":"marine-species-taxonomic-lookup-cf977f7d","name":"Marine Species Taxonomic Lookup","description":"Looks a marine organism up in the taxonomically curated register rather than in an aggregator, and returns the accepted name with its AphiaID, the authority, the rank, the full classification and the recorded status. Where the queried name is not the accepted one, the accepted name is given together with the status term that explains why — unaccepted, alternate representation, nomen dubium and the rest each mean something different to a taxonomist and are passed through rather than flattened…","url":"https://natur.halowerk.com/v1/marine-species","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"name":{"type":"string","maxLength":200,"minLength":2,"description":"Scientific name, e.g. Gadus morhua."},"fuzzy":{"type":"boolean","default":false,"description":"Allow approximate matching. Off by default because a near miss in taxonomy is a wrong answer."},"marine_only":{"type":"boolean","default":false,"description":"Restrict to taxa the register marks as marine."},"include_synonyms":{"type":"boolean","default":true}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_emZURaFnecBukbebUeDGl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up a marine organism by name in the World Register of Marine Species (WoRMS) and returns the accepted name, AphiaID, authority, rank, full classification, and taxonomic status with precise status terminology.","exampleAgentPrompt":"Can you look up 'Tursiops truncatus' in the marine species register and tell me its accepted name, AphiaID, full taxonomic classification, and whether that name is currently accepted or if there's a different preferred name?","exampleUseCases":[{"title":"Validating species names in a dataset","prompt":"I have a list of marine species names from a research dataset and I need to check whether 'Solea solea' is the accepted scientific name or if it's been synonymised — can you look it up and give me the accepted name, AphiaID, and the exact status?"},{"title":"Resolving a synonym in a field report","prompt":"My field report lists 'Crangon vulgaris' as the species but a colleague says it's an old synonym — can you check the marine taxonomy register and tell me what the currently accepted name is and what status term applies to 'Crangon vulgaris'?"},{"title":"Building a species information card","prompt":"I'm putting together a fact sheet on the Lion's Mane jellyfish — can you look it up in the marine species register and give me its accepted scientific name, authority, AphiaID, and the full taxonomic hierarchy from kingdom down to species?"}],"resultDescription":"Returns the accepted scientific name with its AphiaID, the taxonomic authority (author and year), the rank, a full classification hierarchy from kingdom to species level, and a precise status term (accepted, unaccepted, alternate representation, nomen dubium, etc.). When the queried name is not the accepted one, the accepted name is provided alongside the specific status explaining why.","failureModes":["Name not found in the register — returns no match or empty result","Ambiguous name matching multiple taxa — may return multiple candidates or require disambiguation","Network or upstream WoRMS service unavailability — returns 5xx error","Malformed input (empty or non-string name) — returns 4xx validation error","Name is known but lacks a resolved accepted form — status returned without accepted name"],"whenToPreferThis":"Choose this endpoint when you need authoritative, taxonomically precise information about a marine species name — especially when correctness of nomenclature matters (scientific publishing, biodiversity databases, regulatory compliance). Prefer this over generalist aggregators when you need the exact WoRMS-curated status term (e.g. distinguishing 'nomen dubium' from 'alternate representation') rather than a simple valid/invalid flag. Ideal for resolving synonyms, validating dataset names, or building species-level metadata for marine organisms.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:31:30.443Z","isFirstParty":false}