{"openapi":"3.1.0","info":{"title":"DaData (BYOK) API","version":"0.1.0","description":"DaData (BYOK) lets an AI assistant read your own DaData data through the DaData API with a key you supply (DaData API key). Read-only: 8 tools (suggest_address, find_address_by_id, geolocate_address, locate_ip, suggest_party, find_party_by_inn, suggest_bank, find_bank). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-dadata.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-dadata/docs"},"termsOfService":"https://connectorbay.com/byok-dadata/terms"},"servers":[{"url":"https://byok-dadata.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-dadata/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/suggest_address":{"post":{"operationId":"suggest_address","summary":"Search addresses by any part, with typo and layout correction. Works for Russia down to the flat, for Belarus, Kazakhsta","description":"Search addresses by any part, with typo and layout correction. Works for Russia down to the flat, for Belarus, Kazakhstan and Uzbekistan down to the house, and to city level elsewhere. Returns postal code, region, city, street, house, coordinates and FIAS and KLADR codes. Free up to 10,000 requests a day. Use for \"What is the full address for 'москва хабар'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Address text to complete, up to 300 characters, for example 'москва хабар'.","maxLength":300,"title":"Query","type":"string"},"count":{"anyOf":[{"maximum":20,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many suggestions to return (1 to 20, default 10).","title":"Count"},"language":{"anyOf":[{"enum":["ru","en"],"type":"string"},{"type":"null"}],"default":"ru","description":"Language of the answer: ru (default) or en.","title":"Language"}},"required":["query"],"title":"suggest_addressArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/find_address_by_id":{"post":{"operationId":"find_address_by_id","summary":"Find an address by its FIAS code, KLADR code or cadastral number. Use for \"Which address has the FIAS id 9120b43f-2fae-4","description":"Find an address by its FIAS code, KLADR code or cadastral number. Use for \"Which address has the FIAS id 9120b43f-2fae-4838-a144-85e43c2bfb29\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"FIAS id, KLADR id or cadastral number, for example '9120b43f-2fae-4838-a144-85e43c2bfb29'.","maxLength":300,"title":"Query","type":"string"},"count":{"anyOf":[{"maximum":20,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many suggestions to return (1 to 20, default 10).","title":"Count"},"language":{"anyOf":[{"enum":["ru","en"],"type":"string"},{"type":"null"}],"default":"ru","description":"Language of the answer: ru (default) or en.","title":"Language"}},"required":["query"],"title":"find_address_by_idArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/geolocate_address":{"post":{"operationId":"geolocate_address","summary":"Find the nearest addresses (houses, streets, cities) to a latitude and longitude. Russia only. Use for \"What is the addr","description":"Find the nearest addresses (houses, streets, cities) to a latitude and longitude. Russia only. Use for \"What is the address near 55.601983, 37.359486\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"lat":{"description":"Latitude in degrees.","maximum":90,"minimum":-90,"title":"Lat","type":"number"},"lon":{"description":"Longitude in degrees.","maximum":180,"minimum":-180,"title":"Lon","type":"number"},"radius_meters":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"Search radius in metres (1 to 1000, default 100).","title":"Radius Meters"},"count":{"anyOf":[{"maximum":20,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many suggestions to return (1 to 20, default 10).","title":"Count"},"language":{"anyOf":[{"enum":["ru","en"],"type":"string"},{"type":"null"}],"default":"ru","description":"Language of the answer: ru (default) or en.","title":"Language"}},"required":["lat","lon"],"title":"geolocate_addressArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/locate_ip":{"post":{"operationId":"locate_ip","summary":"Find the Russian city for an IP address (60 to 80 percent accurate); location is null when the city cannot be told. Use ","description":"Find the Russian city for an IP address (60 to 80 percent accurate); location is null when the city cannot be told. Use for \"Which city is the IP address 46.226.227.20 in\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ip":{"description":"IPv4 or IPv6 address, for example 46.226.227.20.","maxLength":45,"title":"Ip","type":"string"}},"required":["ip"],"title":"locate_ipArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/suggest_party":{"post":{"operationId":"suggest_party","summary":"Search Russian companies and individual entrepreneurs by name, tax number (INN), registration number (OGRN), manager nam","description":"Search Russian companies and individual entrepreneurs by name, tax number (INN), registration number (OGRN), manager name or address, with status, manager, address and main activity code. Use for \"Find the company 'сбербанк' in the Russian company registry\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Company name, INN, OGRN, manager name or address text, for example 'сбербанк'.","maxLength":300,"title":"Query","type":"string"},"count":{"anyOf":[{"maximum":20,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many suggestions to return (1 to 20, default 10).","title":"Count"},"type":{"anyOf":[{"enum":["LEGAL","INDIVIDUAL"],"type":"string"},{"type":"null"}],"default":null,"description":"Limit to legal entities (LEGAL) or individual entrepreneurs (INDIVIDUAL).","title":"Type"}},"required":["query"],"title":"suggest_partyArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/find_party_by_inn":{"post":{"operationId":"find_party_by_inn","summary":"Look up one Russian company or individual entrepreneur by INN, INN/KPP or OGRN: status, registration date, manager, addr","description":"Look up one Russian company or individual entrepreneur by INN, INN/KPP or OGRN: status, registration date, manager, address, activity code and branches. Use for \"Show company details for INN 7707083893\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"INN, INN/KPP or OGRN, for example '7707083893'.","maxLength":40,"title":"Query","type":"string"},"count":{"anyOf":[{"maximum":20,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many suggestions to return (1 to 20, default 10).","title":"Count"},"branch_type":{"anyOf":[{"enum":["MAIN","BRANCH"],"type":"string"},{"type":"null"}],"default":null,"description":"MAIN for the head office only, BRANCH for branches only.","title":"Branch Type"},"kpp":{"anyOf":[{"maxLength":9,"type":"string"},{"type":"null"}],"default":null,"description":"KPP code to pick one branch.","title":"Kpp"}},"required":["query"],"title":"find_party_by_innArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/suggest_bank":{"post":{"operationId":"suggest_bank","summary":"Search Russian banks by name, BIC, SWIFT or INN, with BIC, correspondent account, address and status. Use for \"Find the ","description":"Search Russian banks by name, BIC, SWIFT or INN, with BIC, correspondent account, address and status. Use for \"Find the bank 'сбербанк' and its BIC\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Bank name, BIC, SWIFT or INN, for example 'сбербанк'.","maxLength":300,"title":"Query","type":"string"},"count":{"anyOf":[{"maximum":20,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many suggestions to return (1 to 20, default 10).","title":"Count"}},"required":["query"],"title":"suggest_bankArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/find_bank":{"post":{"operationId":"find_bank","summary":"Look up one Russian bank by BIC, SWIFT, INN, registration number or correspondent account. Use for \"Which bank has BIC 0","description":"Look up one Russian bank by BIC, SWIFT, INN, registration number or correspondent account. Use for \"Which bank has BIC 044525225\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"BIC, SWIFT, INN, registration number or correspondent account, for example '044525225'.","maxLength":40,"title":"Query","type":"string"},"count":{"anyOf":[{"maximum":20,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many suggestions to return (1 to 20, default 10).","title":"Count"}},"required":["query"],"title":"find_bankArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}