Dadata ru

Learn how to use Dadata ru with Composio

Overview

SLUG: DADATA_RU

Description

DaData provides APIs for data validation, standardization, and enrichment, including address parsing, company information retrieval, and more.

Authentication Details

generic_api_key
stringRequired
generic_secret
stringRequired

Connecting to Dadata ru

Create an auth config

Use the dashboard to create an auth config for the Dadata ru toolkit. This allows you to connect multiple Dadata ru accounts to Composio for agents to use.

1

Select App

Navigate to [Dadata ru](https://platform.composio.dev/marketplace/Dadata ru).

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Dadata ru Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4dadata_ru_auth_config_id = "ac_YOUR_DADATA_RU_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10 # Replace this with a method to retrieve an API key from the user.
11 # Or supply your own.
12 user_api_key = input("[!] Enter API key")
13
14 connection_request = composio.connected_accounts.initiate(
15 user_id=user_id,
16 auth_config_id=auth_config_id,
17 config={"auth_scheme": "API_KEY", "val": user_api_key}
18 )
19
20 # API Key authentication is immediate - no redirect needed
21 print(f"Successfully connected Dadata ru for user {user_id}")
22 print(f"Connection status: {connection_request.status}")
23
24 return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, dadata_ru_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the [Dadata ru toolkit’s playground](https://app.composio.dev/app/Dadata ru)

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["DADATA_RU"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17 completion = openai.chat.completions.create(
18 model="gpt-4o",
19 messages=[
20 {
21 "role": "user",
22 "content": task, # Your task here!
23 },
24 ],
25 tools=tools,
26 )
27
28 # Handle Result from tool call
29 result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30 print(f"[!] Completion: {completion}")
31 print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Find Address

Description

Tool to find address by identifier. use when you need full address details from a cadastral number, fias id, or kladr code.

Action Parameters

query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Clean Address

Description

Tool to clean and standardize russian postal addresses. use when you need structured address fields from raw strings.

Action Parameters

addresses
arrayRequired

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Clean Birthdate

Description

Tool to standardize and validate birthdate strings. use after capturing raw birthdate inputs to normalize them to yyyy-mm-dd.

Action Parameters

birthdate
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Clean Email

Description

Tool to standardize and validate email addresses. use when you have raw email input and need to fix typos, correct domains, and classify as personal, corporate, or disposable. use after collecting user-provided emails.

Action Parameters

emails
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Clean Name (FIO)

Description

Tool to standardize and parse full names (fio), detect gender, and return grammatical cases. use when you need structured name parsing and declensions from raw fio inputs.

Action Parameters

fios
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Clean Passport

Description

Tool to validate a russian passport number against the official registry. use after collecting passport details.

Action Parameters

passport
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Clean Phone

Description

Tool to standardize and validate phone numbers. use when you need to convert arbitrary phone inputs into a uniform, validated 11-digit format for further processing.

Action Parameters

phones
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Clean Vehicle

Description

Tool to standardize and parse vehicle data fields. use after obtaining raw vehicle info to extract brand, model, year, vin, and other identifiers.

Action Parameters

vehicles
arrayRequired

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Find Bank

Description

Tool to find bank by bic, swift, inn, or registration number. use when you need full bank details for a specific identifier. provide optional kpp for branch-level queries.

Action Parameters

kpp
string
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Find Car Brand

Description

Tool to find car brand by its identifier. use when you need detailed car brand information by code. example: find details for brand code '1010'.

Action Parameters

query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Find Country

Description

Tool to find country details by iso or numeric code. use when you have a valid country code and need full metadata.

Action Parameters

language
string
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Find Currency

Description

Tool to find currency details by iso 4217 code. use when you have a currency code and need its full metadata.

Action Parameters

query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Find Delivery City IDs

Description

Tool to get delivery service city ids by kladr code. use when you need the cdek, boxberry, or dpd city identifiers for a given kladr code.

Action Parameters

query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Find FMS Unit

Description

Tool to find passport authority (fms unit) by code. use when you have the fms unit code or name and need to retrieve detailed authority information.

Action Parameters

query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Find FTS Unit

Description

Tool to find customs (fts) office by code. use when you have a customs office identifier and need detailed information.

Action Parameters

count
integer
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Find MKTU

Description

Tool to find mktu classification details by code. use when you have an mktu code and need its descriptions and metadata.

Action Parameters

count
integer
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Find OKVED2

Description

Tool to find okved2 classifier entries by code. use when you have an okved2 code and need full metadata.

Action Parameters

query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Find Company or Entrepreneur

Description

Tool to find company or individual entrepreneur details by inn, ogrn, or kpp. use when you have a valid identifier and need full registration data.

Action Parameters

branch_type
string
query
stringRequired
type
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Find Belarus Party by UNP

Description

Tool to find a belarusian company or entrepreneur by unp. use when you have the unp and need the full registry record. example: "find party by unp = 190657494".

Action Parameters

filters
array
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Find Kazakhstan Company by BIN

Description

Tool to find kazakhstan company or entrepreneur details by bin or name. use when you have a bin or official name and need specific registration data for kz entities.

Action Parameters

kpp
string
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Geolocate Address

Description

Tool to find nearest addresses by geographic coordinates. use when you need address suggestions around a specific location.

Action Parameters

count
integer
lat
numberRequired
lon
numberRequired
radius_meters
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Profile Balance

Description

Tool to retrieve current dadata account balance. use before making api calls that consume funds.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Profile Statistics

Description

Tool to get daily aggregated usage statistics per dadata api service. use when you need a breakdown of calls and remaining balances for a specific date.

Action Parameters

date
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Reference Versions

Description

Tool to retrieve the last update dates for dadata reference datasets (fias, egrul, banks, etc.). use before performing operations that depend on the currency of reference data.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: IP Locate Address

Description

Tool to determine russian address by ip. use when you need to resolve an ip to city/region data.

Action Parameters

ip
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Suggest Address

Description

Tool to autocomplete and suggest addresses. use when user types partial address fragments to retrieve possible address completions.

Action Parameters

bounds
array
count
integer
from_bound
object
geo_lat
number
geo_lon
number
language
string
query
stringRequired
radius_meters
integer
restrict_value
boolean
to_bound
object

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Suggest Bank

Description

Tool to autocomplete and suggest banks by partial details. use when you need to find russian banks by name, bic, inn, swift, or registry number.

Action Parameters

count
integer
filters
object
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Suggest Car Brand

Description

Tool to suggest car brands. use when you need to autocomplete or correct partial car brand names in russian or english.

Action Parameters

count
integer
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Suggest Court

Description

Tool to suggest russian courts by name or location. use when user types partial court name or provides filters to retrieve possible court suggestions.

Action Parameters

count
integer
filters
object
locations
array
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Suggest Currency

Description

Tool to suggest currencies by iso 4217 code or name. use when you need currency autocompletion.

Action Parameters

count
integer
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Suggest Email

Description

Tool to autocomplete and suggest email addresses. use when user provides an email prefix and you need possible completions.

Action Parameters

count
integer
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Suggest FMS Unit

Description

Tool to autocomplete and suggest passport issuing authorities. use when you need to lookup russian fms units by partial code or name.

Action Parameters

count
integer
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Suggest FNS Unit

Description

Tool to suggest russian tax inspection units by partial name or code. use when you need to identify a tax inspection authority from incomplete user input. for example, use query='7700' to retrieve units with code 7700.

Action Parameters

count
integer
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Suggest FTS Unit

Description

Tool to autocomplete and suggest russian customs (fts) units. use when user provides partial name or code to retrieve matching offices.

Action Parameters

count
integer
filters
object
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Suggest Metro

Description

Tool to suggest metro stations. use when you need to autocomplete metro station names in russian cities.

Action Parameters

count
integer
filters
array
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Suggest MKTU

Description

Tool to suggest mktu entries. use when you need to autocomplete or find international classifier of goods and services codes based on name or description.

Action Parameters

count
integer
filter
object
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Suggest Name

Description

Tool to autocomplete and suggest full names (fio). use when user types partial name fragments to retrieve possible full name completions.

Action Parameters

count
integer
gender
string
language
string
parts
array
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Suggest OKPD2

Description

Tool to autocomplete and suggest russian product classification codes (okpd2). use when you need to find or validate okpd2 codes by partial queries.

Action Parameters

count
integer
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Suggest OKTMO

Description

Tool to suggest russian municipal territory codes (oktmo). use when user needs to autocomplete or search for oktmo codes by name or code fragment.

Action Parameters

count
integer
query
stringRequired
status
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Suggest OKVED2

Description

Tool to suggest okved2 codes by text query. use when you have a fragment of a russian economic activity code or name and need structured suggestions.

Action Parameters

count
integer
from_bound
object
query
stringRequired
to_bound
object

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Suggest Party

Description

Tool to autocomplete and suggest russian companies or entrepreneurs. use when you have a partial name, inn, ogrn, or address and need structured suggestions.

Action Parameters

branches
string
count
integer
filters
array
query
stringRequired
status
array
type
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Suggest Postal Unit

Description

Tool to suggest russian postal units by index or coordinates. use when autocompleting postal office codes or finding nearby mail offices.

Action Parameters

count
integer
filters
object
query
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired