{"openapi":"3.1.0","info":{"title":"Dorhim Agent API","version":"1.0.0","description":"Versioned API for calling Dorhim tools from agents and applications."},"servers":[{"url":"https://0.0.0.0:3009"}],"paths":{"/api/v1/planner/plants":{"get":{"operationId":"planner_plants_list","tags":["Productivity & planning","Planner"],"summary":"List plant care references","description":"Returns Dorhim's curated plant catalog and verified community additions with conservative watering starting points.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful tool response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"plants":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"commonName":{"type":"string"},"scientificName":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultIntervalDays":{"anyOf":[{"type":"number"},{"type":"null"}]},"careNote":{"anyOf":[{"type":"string"},{"type":"null"}]},"verified":{"type":"boolean"},"source":{"type":"string","enum":["curated","submitted"]}},"required":["key","id","commonName","scientificName","defaultIntervalDays","careNote","verified","source"],"additionalProperties":false}},"disclaimer":{"type":"string"}},"required":["plants","disclaimer"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]}}}},"400":{"$ref":"#/components/responses/ApiError"},"401":{"$ref":"#/components/responses/ApiError"},"403":{"$ref":"#/components/responses/ApiError"},"429":{"$ref":"#/components/responses/ApiError"},"500":{"$ref":"#/components/responses/ApiError"}},"x-dorhim-tool-id":"planner.plants.list","x-dorhim-category":"productivity-planning","x-dorhim-channels":["web","api"],"x-dorhim-tags":["plants","catalog","care","watering"],"x-required-scope":"planner:plants:read","x-rate-limit-per-minute":120,"x-price-credits":0}},"/api/v1/upland/world/cities":{"get":{"operationId":"upland_world_list_cities","tags":["Gaming & digital assets","Upland"],"summary":"List Upland cities","description":"Returns official cities available through the Upland developer API.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful tool response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"metadata":{"type":"object","properties":{"source":{"type":"string"},"isDemo":{"type":"boolean"},"generatedAt":{"type":"string"}},"required":["source","isDemo","generatedAt"],"additionalProperties":{}},"results":{"type":"array","items":{}}},"required":["metadata","results"],"additionalProperties":{}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]}}}},"400":{"$ref":"#/components/responses/ApiError"},"401":{"$ref":"#/components/responses/ApiError"},"403":{"$ref":"#/components/responses/ApiError"},"429":{"$ref":"#/components/responses/ApiError"},"500":{"$ref":"#/components/responses/ApiError"}},"x-dorhim-tool-id":"upland.world.list_cities","x-dorhim-category":"gaming-digital-assets","x-dorhim-channels":["web","api"],"x-dorhim-tags":["cities","world","geography"],"x-required-scope":"upland:world:read","x-rate-limit-per-minute":120,"x-price-credits":0}},"/api/v1/upland/world/neighborhoods":{"get":{"operationId":"upland_world_list_neighborhoods","tags":["Gaming & digital assets","Upland"],"summary":"List Upland neighborhoods","description":"Lists or searches neighborhoods, optionally within one city.","security":[{"bearerAuth":[]}],"parameters":[{"name":"cityId","in":"query","required":false,"schema":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},{"name":"textSearch","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":100}}],"responses":{"200":{"description":"Successful tool response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"metadata":{"type":"object","properties":{"source":{"type":"string"},"isDemo":{"type":"boolean"},"generatedAt":{"type":"string"}},"required":["source","isDemo","generatedAt"],"additionalProperties":{}},"results":{"type":"array","items":{}}},"required":["metadata","results"],"additionalProperties":{}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]}}}},"400":{"$ref":"#/components/responses/ApiError"},"401":{"$ref":"#/components/responses/ApiError"},"403":{"$ref":"#/components/responses/ApiError"},"429":{"$ref":"#/components/responses/ApiError"},"500":{"$ref":"#/components/responses/ApiError"}},"x-dorhim-tool-id":"upland.world.list_neighborhoods","x-dorhim-category":"gaming-digital-assets","x-dorhim-channels":["web","api"],"x-dorhim-tags":["neighborhoods","world","geography"],"x-required-scope":"upland:world:read","x-rate-limit-per-minute":120,"x-price-credits":0}},"/api/v1/upland/world/properties":{"get":{"operationId":"upland_world_search_properties","tags":["Gaming & digital assets","Upland"],"summary":"Search Upland properties","description":"Searches official Upland properties with cursor pagination.","security":[{"bearerAuth":[]}],"parameters":[{"name":"cityId","in":"query","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},{"name":"pageSize","in":"query","required":true,"schema":{"default":25,"type":"integer","minimum":10,"maximum":100}},{"name":"textSearch","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"nextPageToken","in":"query","required":false,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Successful tool response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"metadata":{"type":"object","properties":{"source":{"type":"string"},"isDemo":{"type":"boolean"},"generatedAt":{"type":"string"}},"required":["source","isDemo","generatedAt"],"additionalProperties":{}},"results":{"type":"array","items":{}},"nextPageToken":{"type":"string"}},"required":["metadata","results"],"additionalProperties":{}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]}}}},"400":{"$ref":"#/components/responses/ApiError"},"401":{"$ref":"#/components/responses/ApiError"},"403":{"$ref":"#/components/responses/ApiError"},"429":{"$ref":"#/components/responses/ApiError"},"500":{"$ref":"#/components/responses/ApiError"}},"x-dorhim-tool-id":"upland.world.search_properties","x-dorhim-category":"gaming-digital-assets","x-dorhim-channels":["web","api"],"x-dorhim-tags":["properties","world","marketplace"],"x-required-scope":"upland:world:read","x-rate-limit-per-minute":60,"x-price-credits":0}},"/api/v1/upland/world/properties/{propertyId}":{"get":{"operationId":"upland_world_get_property","tags":["Gaming & digital assets","Upland"],"summary":"Get an Upland property","description":"Returns one official Upland property by ID.","security":[{"bearerAuth":[]}],"parameters":[{"name":"propertyId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":100}}],"responses":{"200":{"description":"Successful tool response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"metadata":{"type":"object","properties":{"source":{"type":"string"},"isDemo":{"type":"boolean"},"generatedAt":{"type":"string"}},"required":["source","isDemo","generatedAt"],"additionalProperties":{}},"property":{}},"required":["metadata","property"],"additionalProperties":{}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]}}}},"400":{"$ref":"#/components/responses/ApiError"},"401":{"$ref":"#/components/responses/ApiError"},"403":{"$ref":"#/components/responses/ApiError"},"429":{"$ref":"#/components/responses/ApiError"},"500":{"$ref":"#/components/responses/ApiError"}},"x-dorhim-tool-id":"upland.world.get_property","x-dorhim-category":"gaming-digital-assets","x-dorhim-channels":["web","api"],"x-dorhim-tags":["property","world","digital-assets"],"x-required-scope":"upland:world:read","x-rate-limit-per-minute":120,"x-price-credits":0}},"/api/v1/upland/portfolio":{"get":{"operationId":"upland_account_get_portfolio","tags":["Gaming & digital assets","Upland"],"summary":"Get the connected Upland portfolio","description":"Returns portfolio data for the Upland account connected to the API-key owner.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful tool response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"metadata":{"type":"object","properties":{"source":{"type":"string"},"isDemo":{"type":"boolean"},"generatedAt":{"type":"string"}},"required":["source","isDemo","generatedAt"],"additionalProperties":{}},"profile":{},"balances":{},"properties":{"type":"object","properties":{"results":{"type":"array","items":{}},"totalResults":{"type":"number"}},"required":["results"],"additionalProperties":{}},"nfts":{"type":"object","properties":{"results":{"type":"array","items":{}},"totalResults":{"type":"number"}},"required":["results"],"additionalProperties":{}}},"required":["metadata","profile","balances","properties","nfts"],"additionalProperties":{}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]}}}},"400":{"$ref":"#/components/responses/ApiError"},"401":{"$ref":"#/components/responses/ApiError"},"403":{"$ref":"#/components/responses/ApiError"},"429":{"$ref":"#/components/responses/ApiError"},"500":{"$ref":"#/components/responses/ApiError"}},"x-dorhim-tool-id":"upland.account.get_portfolio","x-dorhim-category":"gaming-digital-assets","x-dorhim-channels":["web","api"],"x-dorhim-tags":["portfolio","properties","nfts","player"],"x-required-scope":"upland:portfolio:read","x-rate-limit-per-minute":60,"x-price-credits":0}},"/api/v1/upland/collections":{"get":{"operationId":"upland_collections_list","tags":["Gaming & digital assets","Upland"],"summary":"List Upland collections","description":"Returns the available Upland collection catalog.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful tool response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"metadata":{"type":"object","properties":{"source":{"type":"string"},"isDemo":{"type":"boolean"},"generatedAt":{"type":"string"}},"required":["source","isDemo","generatedAt"],"additionalProperties":{}},"results":{"type":"array","items":{}}},"required":["metadata","results"],"additionalProperties":{}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]}}}},"400":{"$ref":"#/components/responses/ApiError"},"401":{"$ref":"#/components/responses/ApiError"},"403":{"$ref":"#/components/responses/ApiError"},"429":{"$ref":"#/components/responses/ApiError"},"500":{"$ref":"#/components/responses/ApiError"}},"x-dorhim-tool-id":"upland.collections.list","x-dorhim-category":"gaming-digital-assets","x-dorhim-channels":["web","api"],"x-dorhim-tags":["collections","catalog","yield"],"x-required-scope":"upland:collections:read","x-rate-limit-per-minute":120,"x-price-credits":0}},"/api/v1/upland/collections/optimizer":{"get":{"operationId":"upland_collections_optimize","tags":["Gaming & digital assets","Upland"],"summary":"Optimize Upland collections","description":"Calculates collection opportunities for the Upland account connected to the API-key owner.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"Successful tool response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"metadata":{"type":"object","properties":{"source":{"type":"string"},"isDemo":{"type":"boolean"},"generatedAt":{"type":"string"}},"required":["source","isDemo","generatedAt"],"additionalProperties":{}},"profile":{},"optimization":{}},"required":["metadata","profile","optimization"],"additionalProperties":{}},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]}}}},"400":{"$ref":"#/components/responses/ApiError"},"401":{"$ref":"#/components/responses/ApiError"},"403":{"$ref":"#/components/responses/ApiError"},"429":{"$ref":"#/components/responses/ApiError"},"500":{"$ref":"#/components/responses/ApiError"}},"x-dorhim-tool-id":"upland.collections.optimize","x-dorhim-category":"gaming-digital-assets","x-dorhim-channels":["web","api"],"x-dorhim-tags":["collections","optimizer","portfolio","yield"],"x-required-scope":"upland:collections:read","x-rate-limit-per-minute":30,"x-price-credits":0}},"/api/v1/company/lei-search":{"post":{"operationId":"company_lei_search","tags":["Companies & business","Company Intelligence"],"summary":"Resolve legal entities through GLEIF","description":"Searches the public GLEIF LEI dataset and returns normalized legal identity, jurisdiction, status, address locality and registration evidence.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string","minLength":2,"maxLength":160},"limit":{"default":10,"type":"integer","minimum":1,"maximum":20}},"required":["query","limit"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful tool response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string"},"totalMatches":{"anyOf":[{"type":"number"},{"type":"null"}]},"entities":{"type":"array","items":{"type":"object","properties":{"lei":{"type":"string"},"legalName":{"type":"string"},"otherNames":{"type":"array","items":{"type":"string"}},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}]},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"legalForm":{"anyOf":[{"type":"string"},{"type":"null"}]},"legalAddress":{"anyOf":[{"type":"object","properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"country":{"anyOf":[{"type":"string"},{"type":"null"}]},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["city","region","country","postalCode"],"additionalProperties":false},{"type":"null"}]},"headquartersAddress":{"anyOf":[{"type":"object","properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"country":{"anyOf":[{"type":"string"},{"type":"null"}]},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["city","region","country","postalCode"],"additionalProperties":false},{"type":"null"}]},"registration":{"type":"object","properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"initialDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastUpdatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"nextRenewalAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"corroborationLevel":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","initialDate","lastUpdatedAt","nextRenewalAt","corroborationLevel"],"additionalProperties":false},"bic":{"type":"array","items":{"type":"string"}}},"required":["lei","legalName","otherNames","status","jurisdiction","category","legalForm","legalAddress","headquartersAddress","registration","bic"],"additionalProperties":false}},"datasetPublishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"meta":{"type":"object","properties":{"retrievedAt":{"type":"string"},"sourceMode":{"type":"string","enum":["live","cached","snapshot","mock"]},"partial":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"sourceMode":{"type":"string","enum":["live","cached","snapshot","mock"]},"retrievedAt":{"type":"string"}},"required":["id","name","url","sourceMode","retrievedAt"],"additionalProperties":false}}},"required":["retrievedAt","sourceMode","partial","warnings","sources"],"additionalProperties":false}},"required":["query","totalMatches","entities","datasetPublishedAt","meta"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]}}}},"400":{"$ref":"#/components/responses/ApiError"},"401":{"$ref":"#/components/responses/ApiError"},"403":{"$ref":"#/components/responses/ApiError"},"429":{"$ref":"#/components/responses/ApiError"},"500":{"$ref":"#/components/responses/ApiError"}},"x-dorhim-tool-id":"company.lei.search","x-dorhim-category":"companies-business","x-dorhim-channels":["api"],"x-dorhim-tags":["company","lei","identity","gleif"],"x-required-scope":"company:lei:read","x-rate-limit-per-minute":20,"x-price-credits":1}},"/api/v1/company/sec-snapshot":{"post":{"operationId":"company_sec_snapshot","tags":["Companies & business","Company Intelligence"],"summary":"Return SEC filer identity and recent filings","description":"Resolves a public SEC filer by CIK, ticker, or exact name and returns normalized company metadata with recent official filing links.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"identifier":{"type":"string","minLength":1,"maxLength":160},"filingLimit":{"default":10,"type":"integer","minimum":1,"maximum":40}},"required":["identifier","filingLimit"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful tool response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"company":{"type":"object","properties":{"cik":{"type":"string"},"name":{"type":"string"},"entityType":{"anyOf":[{"type":"string"},{"type":"null"}]},"sic":{"anyOf":[{"type":"string"},{"type":"null"}]},"sicDescription":{"anyOf":[{"type":"string"},{"type":"null"}]},"tickers":{"type":"array","items":{"type":"string"}},"exchanges":{"type":"array","items":{"type":"string"}},"ein":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"website":{"anyOf":[{"type":"string"},{"type":"null"}]},"investorWebsite":{"anyOf":[{"type":"string"},{"type":"null"}]},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"fiscalYearEnd":{"anyOf":[{"type":"string"},{"type":"null"}]},"stateOfIncorporation":{"anyOf":[{"type":"string"},{"type":"null"}]},"businessAddress":{"anyOf":[{"type":"object","properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["city","region","postalCode"],"additionalProperties":false},{"type":"null"}]},"formerNames":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"from":{"anyOf":[{"type":"string"},{"type":"null"}]},"to":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","from","to"],"additionalProperties":false}}},"required":["cik","name","entityType","sic","sicDescription","tickers","exchanges","ein","description","website","investorWebsite","category","fiscalYearEnd","stateOfIncorporation","businessAddress","formerNames"],"additionalProperties":false},"filings":{"type":"array","items":{"type":"object","properties":{"accessionNumber":{"type":"string"},"form":{"anyOf":[{"type":"string"},{"type":"null"}]},"filedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"reportDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"acceptedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"documentUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["accessionNumber","form","filedAt","reportDate","acceptedAt","description","documentUrl"],"additionalProperties":false}},"meta":{"type":"object","properties":{"retrievedAt":{"type":"string"},"sourceMode":{"type":"string","enum":["live","cached","snapshot","mock"]},"partial":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"sourceMode":{"type":"string","enum":["live","cached","snapshot","mock"]},"retrievedAt":{"type":"string"}},"required":["id","name","url","sourceMode","retrievedAt"],"additionalProperties":false}}},"required":["retrievedAt","sourceMode","partial","warnings","sources"],"additionalProperties":false}},"required":["company","filings","meta"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]}}}},"400":{"$ref":"#/components/responses/ApiError"},"401":{"$ref":"#/components/responses/ApiError"},"403":{"$ref":"#/components/responses/ApiError"},"429":{"$ref":"#/components/responses/ApiError"},"500":{"$ref":"#/components/responses/ApiError"}},"x-dorhim-tool-id":"company.sec.snapshot","x-dorhim-category":"companies-business","x-dorhim-channels":["api"],"x-dorhim-tags":["company","sec","edgar","filings"],"x-required-scope":"company:sec:read","x-rate-limit-per-minute":10,"x-price-credits":1}},"/api/v1/country/intelligence":{"post":{"operationId":"country_intelligence_inspect","tags":["Places & geography","Country Intelligence"],"summary":"Return country identity and recent economic indicators","description":"Combines World Bank country metadata with the latest available population, GDP and GDP-per-capita observations.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"countryCode":{"type":"string","minLength":2,"maxLength":3,"pattern":"^[A-Za-z]{2,3}$"}},"required":["countryCode"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful tool response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"country":{"type":"object","properties":{"iso2Code":{"type":"string"},"iso3Code":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"capitalCity":{"anyOf":[{"type":"string"},{"type":"null"}]},"coordinates":{"anyOf":[{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"required":["latitude","longitude"],"additionalProperties":false},{"type":"null"}]},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"regionCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"incomeLevel":{"anyOf":[{"type":"string"},{"type":"null"}]},"incomeLevelCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"lendingType":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["iso2Code","iso3Code","name","capitalCity","coordinates","region","regionCode","incomeLevel","incomeLevelCode","lendingType"],"additionalProperties":false},"indicators":{"type":"object","properties":{"population":{"anyOf":[{"type":"object","properties":{"indicatorId":{"type":"string"},"name":{"type":"string"},"year":{"anyOf":[{"type":"string"},{"type":"null"}]},"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"unit":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["indicatorId","name","year","value","unit"],"additionalProperties":false},{"type":"null"}]},"gdpCurrentUsd":{"anyOf":[{"type":"object","properties":{"indicatorId":{"type":"string"},"name":{"type":"string"},"year":{"anyOf":[{"type":"string"},{"type":"null"}]},"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"unit":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["indicatorId","name","year","value","unit"],"additionalProperties":false},{"type":"null"}]},"gdpPerCapitaCurrentUsd":{"anyOf":[{"type":"object","properties":{"indicatorId":{"type":"string"},"name":{"type":"string"},"year":{"anyOf":[{"type":"string"},{"type":"null"}]},"value":{"anyOf":[{"type":"number"},{"type":"null"}]},"unit":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["indicatorId","name","year","value","unit"],"additionalProperties":false},{"type":"null"}]}},"required":["population","gdpCurrentUsd","gdpPerCapitaCurrentUsd"],"additionalProperties":false},"meta":{"type":"object","properties":{"retrievedAt":{"type":"string"},"sourceMode":{"type":"string","enum":["live","cached","snapshot","mock"]},"partial":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"sourceMode":{"type":"string","enum":["live","cached","snapshot","mock"]},"retrievedAt":{"type":"string"}},"required":["id","name","url","sourceMode","retrievedAt"],"additionalProperties":false}}},"required":["retrievedAt","sourceMode","partial","warnings","sources"],"additionalProperties":false}},"required":["country","indicators","meta"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]}}}},"400":{"$ref":"#/components/responses/ApiError"},"401":{"$ref":"#/components/responses/ApiError"},"403":{"$ref":"#/components/responses/ApiError"},"429":{"$ref":"#/components/responses/ApiError"},"500":{"$ref":"#/components/responses/ApiError"}},"x-dorhim-tool-id":"country.intelligence.inspect","x-dorhim-category":"places-geography","x-dorhim-channels":["api"],"x-dorhim-tags":["country","population","gdp","world-bank"],"x-required-scope":"country:intelligence","x-rate-limit-per-minute":20,"x-price-credits":1}},"/api/v1/domain/intelligence":{"post":{"operationId":"domain_intelligence_inspect","tags":["Internet & domains","Domain Intelligence"],"summary":"Inspect DNS and public domain registration data","description":"Returns normalized DNS records and public RDAP registration evidence without using paid data providers.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"domain":{"type":"string","minLength":3,"maxLength":253}},"required":["domain"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful tool response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"domain":{"type":"string"},"dns":{"type":"object","properties":{"ipv4":{"type":"array","items":{"type":"string"}},"ipv6":{"type":"array","items":{"type":"string"}},"nameservers":{"type":"array","items":{"type":"string"}},"mailExchangers":{"type":"array","items":{"type":"object","properties":{"host":{"type":"string"},"priority":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["host","priority"],"additionalProperties":false}},"txt":{"type":"array","items":{"type":"string"}},"caa":{"type":"array","items":{"type":"object","properties":{"critical":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tag":{"type":"string"},"value":{"type":"string"}},"required":["critical","tag","value"],"additionalProperties":false}}},"required":["ipv4","ipv6","nameservers","mailExchangers","txt","caa"],"additionalProperties":false},"registration":{"anyOf":[{"type":"object","properties":{"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"statuses":{"type":"array","items":{"type":"string"}},"registrar":{"anyOf":[{"type":"object","properties":{"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["handle","name"],"additionalProperties":false},{"type":"null"}]},"events":{"type":"array","items":{"type":"object","properties":{"action":{"type":"string"},"at":{"type":"string"}},"required":["action","at"],"additionalProperties":false}},"nameservers":{"type":"array","items":{"type":"string"}},"dnssecSigned":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"termsUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["handle","name","statuses","registrar","events","nameservers","dnssecSigned","termsUrl"],"additionalProperties":false},{"type":"null"}]},"meta":{"type":"object","properties":{"retrievedAt":{"type":"string"},"sourceMode":{"type":"string","enum":["live","cached","snapshot","mock"]},"partial":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"sourceMode":{"type":"string","enum":["live","cached","snapshot","mock"]},"retrievedAt":{"type":"string"}},"required":["id","name","url","sourceMode","retrievedAt"],"additionalProperties":false}}},"required":["retrievedAt","sourceMode","partial","warnings","sources"],"additionalProperties":false}},"required":["domain","dns","registration","meta"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]}}}},"400":{"$ref":"#/components/responses/ApiError"},"401":{"$ref":"#/components/responses/ApiError"},"403":{"$ref":"#/components/responses/ApiError"},"429":{"$ref":"#/components/responses/ApiError"},"500":{"$ref":"#/components/responses/ApiError"}},"x-dorhim-tool-id":"domain.intelligence.inspect","x-dorhim-category":"internet-domains","x-dorhim-channels":["api"],"x-dorhim-tags":["domain","dns","rdap","registration"],"x-required-scope":"domain:intelligence","x-rate-limit-per-minute":5,"x-price-credits":1}},"/api/v1/business/eu-vat-verify":{"post":{"operationId":"business_eu_vat_verify","tags":["Companies & business","EU Business Intelligence"],"summary":"Verify an EU VAT number","description":"Validates an EU VAT number against the official European Commission VIES service and returns normalized evidence.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"countryCode":{"type":"string","pattern":"^(?:AT|BE|BG|CY|CZ|DE|DK|EE|EL|ES|FI|FR|HR|HU|IE|IT|LT|LU|LV|MT|NL|PL|PT|RO|SE|SI|SK|XI|GR)$"},"vatNumber":{"type":"string","minLength":2,"maxLength":20,"pattern":"^[A-Za-z0-9\\s.\\-/]+$"},"requesterCountryCode":{"type":"string","pattern":"^(?:AT|BE|BG|CY|CZ|DE|DK|EE|EL|ES|FI|FR|HR|HU|IE|IT|LT|LU|LV|MT|NL|PL|PT|RO|SE|SI|SK|XI|GR)$"},"requesterVatNumber":{"type":"string","minLength":2,"maxLength":20,"pattern":"^[A-Za-z0-9\\s.\\-/]+$"},"traderName":{"type":"string","minLength":1,"maxLength":200},"traderStreet":{"type":"string","minLength":1,"maxLength":200},"traderPostalCode":{"type":"string","minLength":1,"maxLength":30},"traderCity":{"type":"string","minLength":1,"maxLength":100}},"required":["countryCode","vatNumber"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful tool response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"verification":{"type":"object","properties":{"countryCode":{"type":"string"},"vatNumber":{"type":"string"},"valid":{"type":"boolean"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"requestIdentifier":{"anyOf":[{"type":"string"},{"type":"null"}]},"checkedAt":{"type":"string"}},"required":["countryCode","vatNumber","valid","name","address","requestIdentifier","checkedAt"],"additionalProperties":false},"matches":{"type":"object","properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"street":{"anyOf":[{"type":"string"},{"type":"null"}]},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","street","postalCode","city"],"additionalProperties":false},"evidence":{"type":"object","properties":{"source":{"type":"string"},"sourceUrl":{"type":"string","format":"uri"},"retrievedAt":{"type":"string"}},"required":["source","sourceUrl","retrievedAt"],"additionalProperties":false}},"required":["verification","matches","evidence"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]}}}},"400":{"$ref":"#/components/responses/ApiError"},"401":{"$ref":"#/components/responses/ApiError"},"403":{"$ref":"#/components/responses/ApiError"},"429":{"$ref":"#/components/responses/ApiError"},"500":{"$ref":"#/components/responses/ApiError"}},"x-dorhim-tool-id":"business.eu_vat.verify","x-dorhim-category":"companies-business","x-dorhim-channels":["api"],"x-dorhim-tags":["vat","company","verification","europe"],"x-required-scope":"business:vat:verify","x-rate-limit-per-minute":30,"x-price-credits":1}},"/api/v1/procurement/ted/search":{"post":{"operationId":"procurement_ted_search","tags":["Companies & business","Procurement Intelligence"],"summary":"Search published EU procurement notices","description":"Runs a bounded TED expert query and returns normalized notice identity, titles, buyers, deadlines, classifications and official evidence links.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expertQuery":{"type":"string","minLength":3,"maxLength":500},"language":{"default":"eng","type":"string","pattern":"^[a-z]{3}$"},"limit":{"default":10,"type":"integer","minimum":1,"maximum":20}},"required":["expertQuery","language","limit"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful tool response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expertQuery":{"type":"string"},"totalMatches":{"anyOf":[{"type":"number"},{"type":"null"}]},"notices":{"type":"array","items":{"type":"object","properties":{"publicationNumber":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"buyers":{"type":"array","items":{"type":"string"}},"noticeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"deadlines":{"type":"array","items":{"type":"string"}},"classifications":{"type":"array","items":{"type":"string"}},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"xmlUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["publicationNumber","title","buyers","noticeType","deadlines","classifications","url","xmlUrl"],"additionalProperties":false}},"meta":{"type":"object","properties":{"retrievedAt":{"type":"string"},"sourceMode":{"type":"string","enum":["live","cached","snapshot","mock"]},"partial":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"sourceMode":{"type":"string","enum":["live","cached","snapshot","mock"]},"retrievedAt":{"type":"string"}},"required":["id","name","url","sourceMode","retrievedAt"],"additionalProperties":false}}},"required":["retrievedAt","sourceMode","partial","warnings","sources"],"additionalProperties":false}},"required":["expertQuery","totalMatches","notices","meta"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]}}}},"400":{"$ref":"#/components/responses/ApiError"},"401":{"$ref":"#/components/responses/ApiError"},"403":{"$ref":"#/components/responses/ApiError"},"429":{"$ref":"#/components/responses/ApiError"},"500":{"$ref":"#/components/responses/ApiError"}},"x-dorhim-tool-id":"procurement.ted.search","x-dorhim-category":"companies-business","x-dorhim-channels":["api"],"x-dorhim-tags":["procurement","tenders","buyers","ted","europe"],"x-required-scope":"procurement:ted:read","x-rate-limit-per-minute":10,"x-price-credits":1}},"/api/v1/research/papers/search":{"post":{"operationId":"research_papers_search","tags":["News & information","Research Intelligence"],"summary":"Search scholarly metadata with citation evidence","description":"Searches Crossref and returns normalized papers, authors, affiliations, DOI identity, publication dates and citation counts.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string","minLength":3,"maxLength":300},"limit":{"default":10,"type":"integer","minimum":1,"maximum":20},"fromYear":{"type":"integer","minimum":1800,"maximum":2200},"untilYear":{"type":"integer","minimum":1800,"maximum":2200}},"required":["query","limit"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful tool response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string"},"totalMatches":{"anyOf":[{"type":"number"},{"type":"null"}]},"papers":{"type":"array","items":{"type":"object","properties":{"doi":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"containerTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}]},"citationCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"subjects":{"type":"array","items":{"type":"string"}},"authors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"orcid":{"anyOf":[{"type":"string"},{"type":"null"}]},"affiliations":{"type":"array","items":{"type":"string"}}},"required":["name","orcid","affiliations"],"additionalProperties":false}},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["doi","title","subtitle","type","publishedAt","containerTitle","publisher","citationCount","subjects","authors","url"],"additionalProperties":false}},"meta":{"type":"object","properties":{"retrievedAt":{"type":"string"},"sourceMode":{"type":"string","enum":["live","cached","snapshot","mock"]},"partial":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"sourceMode":{"type":"string","enum":["live","cached","snapshot","mock"]},"retrievedAt":{"type":"string"}},"required":["id","name","url","sourceMode","retrievedAt"],"additionalProperties":false}}},"required":["retrievedAt","sourceMode","partial","warnings","sources"],"additionalProperties":false}},"required":["query","totalMatches","papers","meta"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]}}}},"400":{"$ref":"#/components/responses/ApiError"},"401":{"$ref":"#/components/responses/ApiError"},"403":{"$ref":"#/components/responses/ApiError"},"429":{"$ref":"#/components/responses/ApiError"},"500":{"$ref":"#/components/responses/ApiError"}},"x-dorhim-tool-id":"research.papers.search","x-dorhim-category":"news-information","x-dorhim-channels":["api"],"x-dorhim-tags":["research","papers","doi","citations","crossref"],"x-required-scope":"research:papers:read","x-rate-limit-per-minute":10,"x-price-credits":1}},"/api/v1/url/intelligence":{"post":{"operationId":"url_intelligence_inspect","tags":["Internet & domains","URL Intelligence"],"summary":"Inspect and verify a public URL","description":"Returns redirects, response metadata, canonical/robots metadata, Open Graph fields and structured-data types while blocking private-network targets.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri"}},"required":["url"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful tool response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"requestedUrl":{"type":"string"},"finalUrl":{"type":"string","format":"uri"},"status":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ok":{"type":"boolean"},"redirects":{"type":"array","items":{"type":"object","properties":{"status":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"from":{"type":"string","format":"uri"},"to":{"type":"string","format":"uri"}},"required":["status","from","to"],"additionalProperties":false}},"transport":{"type":"object","properties":{"protocol":{"type":"string"},"contentType":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentLength":{"anyOf":[{"type":"number"},{"type":"null"}]},"cacheControl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["protocol","contentType","contentLength","cacheControl"],"additionalProperties":false},"page":{"anyOf":[{"type":"object","properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"canonical":{"anyOf":[{"type":"string"},{"type":"null"}]},"robots":{"anyOf":[{"type":"string"},{"type":"null"}]},"openGraph":{"type":"object","properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["title","description","type"],"additionalProperties":false},"structuredDataTypes":{"type":"array","items":{"type":"string"}}},"required":["title","description","canonical","robots","openGraph","structuredDataTypes"],"additionalProperties":false},{"type":"null"}]},"evidence":{"type":"object","properties":{"retrievedAt":{"type":"string"},"bodyInspected":{"type":"boolean"},"maximumBodyBytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["retrievedAt","bodyInspected","maximumBodyBytes"],"additionalProperties":false}},"required":["requestedUrl","finalUrl","status","ok","redirects","transport","page","evidence"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMeta"}},"required":["data","meta"]}}}},"400":{"$ref":"#/components/responses/ApiError"},"401":{"$ref":"#/components/responses/ApiError"},"403":{"$ref":"#/components/responses/ApiError"},"429":{"$ref":"#/components/responses/ApiError"},"500":{"$ref":"#/components/responses/ApiError"}},"x-dorhim-tool-id":"url.intelligence.inspect","x-dorhim-category":"internet-domains","x-dorhim-channels":["api"],"x-dorhim-tags":["url","website","metadata","redirects"],"x-required-scope":"url:intelligence","x-rate-limit-per-minute":30,"x-price-credits":1}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"Dorhim API key"}},"schemas":{"ResponseMeta":{"type":"object","properties":{"requestId":{"type":"string"},"tool":{"type":"string"},"creditsCharged":{"type":"integer"}},"required":["requestId","tool","creditsCharged"]}},"responses":{"ApiError":{"description":"API error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"]}},"required":["error"]}}}}}}}