> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to DaData

The DaData connector lets your AI agent act in each user's DaData account. Each user connects their own DaData API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 47 tools.

**Authentication:** API Key
**Categories:** Analytics, Search
**Tools:** 47: 47 read, 0 write, 0 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=DADATA)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the DaData connection

   In **AgentKit > Connections**, create a DaData connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'dadata'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize DaData:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'dadata_address_find',
     toolInput: { query: '9120b43f-2fae-4838-a144-85e43c2bfb29' },
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "dadata"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize DaData:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={"query":"9120b43f-2fae-4838-a144-85e43c2bfb29"},
       tool_name="dadata_address_find",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their DaData credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'dadata_address_find',
  toolInput: {
    query: '<query>',
  },
  connector: 'dadata',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="dadata_address_find",
    tool_input={
        "query": "<query>",
    },
    connection_name="dadata",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `dadata_address_find`

Find Address by ID · Read-only

Find an address by an exact identifier: FIAS or GAR ID, KLADR code, or cadastral number of a building. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to expand a stored ID into a full address. Use dadata_address_suggest for free text.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): FIAS/GAR ID, KLADR code or cadastral number of the address. Example: 9120b43f-2fae-4838-a144-85e43c2bfb29.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `division` (`string`, optional): Address hierarchy to use: ADMINISTRATIVE (the default) or MUNICIPAL division. Example: MUNICIPAL. One of: `ADMINISTRATIVE`, `MUNICIPAL`.
- `language` (`string`, optional): Language of the returned addresses: ru (Russian, the default) or en (transliterated). Example: en. One of: `ru`, `en`.

Example input: `{"query":"<query>"}`

### `dadata_address_geolocate`

Find Addresses Near Coordinates · Read-only

Reverse-geocode: find the addresses nearest to a latitude and longitude in Russia, nearest first. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to turn coordinates into a street address. Use dadata_address_iplocate to find a city from an IP address.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lat` (`number`, required): Latitude in decimal degrees. Example: 55.878.
- `lon` (`number`, required): Longitude in decimal degrees. Example: 37.653.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `division` (`string`, optional): Address hierarchy to use: ADMINISTRATIVE (the default) or MUNICIPAL division. Example: MUNICIPAL. One of: `ADMINISTRATIVE`, `MUNICIPAL`.
- `language` (`string`, optional): Language of the returned addresses: ru (Russian, the default) or en (transliterated). Example: en. One of: `ru`, `en`.
- `radius_meters` (`integer`, optional): Search radius in meters. Defaults to 100, maximum 1000. Example: 50.

Example input: `{"lat":55.878,"lon":37.653}`

### `dadata_address_iplocate`

Find City by IP Address · Read-only

Detect the Russian city of an IP address. Returns a location object with the city's address data (region, city, KLADR and FIAS IDs, coordinates), or null when the city cannot be determined. Use this to pre-fill a city for a visitor. Accuracy is 60 to 80 percent.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ip` (`string`, required): IPv4 or IPv6 address to locate. Example: 46.226.227.20.
- `division` (`string`, optional): Address hierarchy to use: ADMINISTRATIVE (the default) or MUNICIPAL division. Example: MUNICIPAL. One of: `ADMINISTRATIVE`, `MUNICIPAL`.
- `language` (`string`, optional): Language of the returned addresses: ru (Russian, the default) or en (transliterated). Example: en. One of: `ru`, `en`.

Example input: `{"ip":"<ip>"}`

### `dadata_address_suggest`

Suggest Addresses · Read-only

Suggest Russian (or, with locations country *, worldwide) postal addresses for free-text input, using the FIAS (GAR) register. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Data includes postal code, region, city, street, house, FIAS and KLADR IDs, coordinates and OKATO/OKTMO codes. Use this to autocomplete or normalize an address typed by a person. Use dadata_address_find for an exact FIAS or KLADR ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Address text to complete, up to 300 characters, e.g. a street and city. Example: москва хабар.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `division` (`string`, optional): Address hierarchy to use: ADMINISTRATIVE (the default) or MUNICIPAL division. Example: MUNICIPAL. One of: `ADMINISTRATIVE`, `MUNICIPAL`.
- `from_bound` (`object`, optional): Lowest address level to suggest, as {"value": level}. Levels: country, region, area, city, settlement, street, house, flat. Use with to_bound to suggest e.g. only cities. Example: {"value": "city"}
- `language` (`string`, optional): Language of the returned addresses: ru (Russian, the default) or en (transliterated). Example: en. One of: `ru`, `en`.
- `locations` (`array`, optional): Limit results to these parent areas, as a list of objects such as {"region": "москва"}, {"kladr_id": "7700000000000"}, {"fias_id": "..."} or {"country": "*"} for all countries. At most 10 objects. Example: [{"region": "москва"}]
- `locations_boost` (`array`, optional): Rank results from these cities first, as a list of objects with a kladr_id, e.g. [{"kladr_id": "77"}]. At most 10 objects. Example: [{"kladr_id": "77"}]
- `locations_geo` (`array`, optional): Limit results to circles around points, as a list of objects with lat, lon and radius_meters, e.g. [{"lat": 59.94, "lon": 30.31, "radius_meters": 1000}]. Example: [{"lat": 59.94, "lon": 30.31, "radius_meters": 1000}]
- `to_bound` (`object`, optional): Highest address level to suggest, as {"value": level}, e.g. {"value": "settlement"}. Example: {"value": "settlement"}

Example input: `{"query":"<query>"}`

### `dadata_bank_find`

Find Bank by BIC, SWIFT or INN · Read-only

Find a Russian bank by an exact BIC, SWIFT code, INN, INN/KPP or Bank of Russia registration number. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to get payment details for a known identifier. Use dadata_bank_suggest for names or partial input.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): BIC, SWIFT, INN, INN/KPP or registration number. Example: 044525225.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_bank_suggest`

Suggest Banks · Read-only

Suggest Russian banks and credit organizations for a name, BIC, SWIFT, INN or address. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Data includes BIC, SWIFT, INN, KPP, correspondent account, registration number, address and status. Use this to autocomplete a bank. Use dadata_bank_find for an exact BIC.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Bank name, BIC, SWIFT, INN or address. Example: сбер.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `locations` (`array`, optional): Limit results to these parent areas, as a list of objects such as {"region": "москва"}, {"kladr_id": "7700000000000"}, {"fias_id": "..."} or {"country": "*"} for all countries. At most 10 objects. Example: [{"region": "москва"}]
- `locations_boost` (`array`, optional): Rank results from these cities first, as a list of objects with a kladr_id, e.g. [{"kladr_id": "77"}]. At most 10 objects. Example: [{"kladr_id": "77"}]
- `status` (`array`, optional): Limit to these statuses: ACTIVE, LIQUIDATING, LIQUIDATED. Example: ["ACTIVE"]
- `type` (`array`, optional): Limit to these types: BANK, BANK_BRANCH, NKO, NKO_BRANCH, RKC, CBR, TREASURY, OTHER. Example: ["BANK"]

Example input: `{"query":"<query>"}`

### `dadata_car_brand_find`

Find Car Brands by Code · Read-only

Find one entry of the Car Brands directory by its exact brand ID. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this when the code is known. Use dadata_car_brand_suggest for text.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Exact brand ID. Example: FORD.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_car_brand_suggest`

Suggest Car Brands · Read-only

Suggest car brands by name in Russian or English for partial input. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to autocomplete a value from the directory. Use dadata_car_brand_find for an exact code.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Name or part of the code to search. Example: форд.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `filters` (`array`, optional): Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].

Example input: `{"query":"<query>"}`

### `dadata_country_find`

Find Countries by Code · Read-only

Find one entry of the Countries directory by its exact ISO alpha-2, alpha-3 or numeric country code. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this when the code is known. Use dadata_country_suggest for text.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Exact ISO alpha-2, alpha-3 or numeric country code. Example: TH.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_country_suggest`

Suggest Countries · Read-only

Suggest countries (OKSM) by name or code for partial input. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to autocomplete a value from the directory. Use dadata_country_find for an exact code.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Name or part of the code to search. Example: та.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `filters` (`array`, optional): Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].

Example input: `{"query":"<query>"}`

### `dadata_court_find`

Find Court by Code · Read-only

Find a Russian court by its exact code, e.g. 52MS0022. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this when the court code is known. Use dadata_court_suggest for text.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Court code. Example: 52MS0022.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_court_suggest`

Suggest Courts · Read-only

Suggest Russian courts (magistrates', district, regional and arbitration courts) for a name, code or address. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Data has the court code, name, type, address and payment details. Use this to find a court. Use dadata_court_find for an exact court code.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Court name, code or address. Example: нижний.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `filters` (`array`, optional): Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].

Example input: `{"query":"<query>"}`

### `dadata_currency_find`

Find Currencies by Code · Read-only

Find one entry of the Currencies directory by its exact numeric or ISO currency code. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this when the code is known. Use dadata_currency_suggest for text.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Exact numeric or ISO currency code. Example: 643.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_currency_suggest`

Suggest Currencies · Read-only

Suggest currencies (OKV) by name or code for partial input. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to autocomplete a value from the directory. Use dadata_currency_find for an exact code.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Name or part of the code to search. Example: руб.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `filters` (`array`, optional): Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].

Example input: `{"query":"<query>"}`

### `dadata_delivery_find`

Find Delivery Service City IDs · Read-only

Get the city IDs used by the delivery services CDEK, Boxberry and DPD for a KLADR or FIAS ID of a city. Returns a suggestions array whose data has kladr_id, fias_id, boxberry_id, cdek_id and dpd_id. Use this to map a DaData city to a courier's city code.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): KLADR code or FIAS ID of a city or settlement. Example: 3100400100000.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_email_suggest`

Suggest Email Addresses · Read-only

Suggest the completion of an email address, mainly its domain after the @. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Data has local and domain. Use this to autocomplete an email typed by a person.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Partial email address. Example: anton@m.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_fio_suggest`

Suggest Person Names · Read-only

Suggest Russian full names (surname, name, patronymic) for partial input and detect gender. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Data has surname, name, patronymic and gender. Use this to autocomplete or split a person's name.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Part of a full name. Example: викт.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `gender` (`string`, optional): Limit to one gender. Example: MALE. One of: `UNKNOWN`, `MALE`, `FEMALE`.
- `parts` (`array`, optional): Suggest only these name parts: SURNAME, NAME, PATRONYMIC. Example: ["NAME"]

Example input: `{"query":"<query>"}`

### `dadata_fms_unit_suggest`

Suggest Passport Issuing Offices · Read-only

Suggest the passport issuing office (FMS/MVD unit) for a subdivision code or name. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Data has code, name, region_code and type. Use this to fill in 'issued by' for a Russian passport.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Subdivision code (e.g. 772-053) or office name. Example: 772-053.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `filters` (`array`, optional): Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].

Example input: `{"query":"<query>"}`

### `dadata_fns_unit_find`

Find Tax Office by Code · Read-only

Find a Russian tax office (FNS inspection) by its exact four-digit code. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this when the code is known. Use dadata_fns_unit_suggest for text.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Four-digit tax office code. Example: 5257.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_fns_unit_suggest`

Suggest Tax Offices · Read-only

Suggest Russian tax offices (FNS inspections) for a code, name or address. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Data has the office code, name, OKPO, address, phone and payment details. Use this to find a tax office. Use dadata_fns_unit_find for an exact code.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Tax office code, name or address. Example: межрайонная.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `filters` (`array`, optional): Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].

Example input: `{"query":"<query>"}`

### `dadata_forwarder_find`

Find Freight Forwarder · Read-only

Find a Russian freight forwarder in the forwarders register by INN, OGRN or register number. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to check that a forwarder is registered.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): INN, OGRN or register number of the forwarder. Example: 7704217370.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_fts_unit_find`

Find Customs Office by Code · Read-only

Find a Russian customs office (FTS unit) by its exact code. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this when the code is known. Use dadata_fts_unit_suggest for text.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Customs office code. Example: 10511000.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_fts_unit_suggest`

Suggest Customs Offices · Read-only

Suggest Russian customs offices (FTS units) for a code or name. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to find a customs office. Use dadata_fts_unit_find for an exact code.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Customs office code or name. Example: свердлов.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `filters` (`array`, optional): Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].

Example input: `{"query":"<query>"}`

### `dadata_medical_position_find`

Find Medical Positions by Code · Read-only

Find one entry of the Medical Positions directory by its exact position ID. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this when the code is known. Use dadata_medical_position_suggest for text.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Exact position ID. Example: 1035.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_medical_position_suggest`

Suggest Medical Positions · Read-only

Suggest positions of medical workers from the official directory for partial input. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to autocomplete a value from the directory. Use dadata_medical_position_find for an exact code.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Name or part of the code to search. Example: хирург.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `filters` (`array`, optional): Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].

Example input: `{"query":"<query>"}`

### `dadata_metro_suggest`

Suggest Metro Stations · Read-only

Suggest metro stations in Russian cities for a station name. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Data has the station name, line, city, coordinates and is_closed. Use this to autocomplete a metro station; filter by city with filters.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Part of a station name. Example: алек.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `filters` (`array`, optional): Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].

Example input: `{"query":"<query>"}`

### `dadata_mktu_find`

Find ICGS (MKTU) Classes by Code · Read-only

Find one entry of the ICGS directory by its exact ICGS/MKTU item number. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this when the code is known. Use dadata_mktu_suggest for text.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Exact ICGS/MKTU item number. Example: 060137.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_mktu_suggest`

Suggest ICGS (MKTU) Classes · Read-only

Suggest goods and services of the international trademark classification (ICGS/MKTU) for partial input. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to autocomplete a value from the directory. Use dadata_mktu_find for an exact code.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Name or part of the code to search. Example: шуруп.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `filters` (`array`, optional): Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].

Example input: `{"query":"<query>"}`

### `dadata_okpd2_find`

Find OKPD2 Product Codes by Code · Read-only

Find one entry of the OKPD2 Product Codes directory by its exact OKPD2 code. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this when the code is known. Use dadata_okpd2_suggest for text.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Exact OKPD2 code. Example: 95.23.10.133.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_okpd2_suggest`

Suggest OKPD2 Product Codes · Read-only

Suggest OKPD2 product and service codes by name or code for partial input. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to autocomplete a value from the directory. Use dadata_okpd2_find for an exact code.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Name or part of the code to search. Example: калоши.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `filters` (`array`, optional): Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].

Example input: `{"query":"<query>"}`

### `dadata_okpdtr_position_find`

Find OKPDTR Positions by Code · Read-only

Find one entry of the OKPDTR Positions directory by its exact OKPDTR position code. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this when the code is known. Use dadata_okpdtr_position_suggest for text.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Exact OKPDTR position code. Example: 21495.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_okpdtr_position_suggest`

Suggest OKPDTR Positions · Read-only

Suggest employee positions from the OKPDTR classifier for partial input. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to autocomplete a value from the directory. Use dadata_okpdtr_position_find for an exact code.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Name or part of the code to search. Example: директор.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `filters` (`array`, optional): Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].

Example input: `{"query":"<query>"}`

### `dadata_okpdtr_profession_find`

Find OKPDTR Professions by Code · Read-only

Find one entry of the OKPDTR Professions directory by its exact OKPDTR profession code. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this when the code is known. Use dadata_okpdtr_profession_suggest for text.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Exact OKPDTR profession code. Example: 11442.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_okpdtr_profession_suggest`

Suggest OKPDTR Professions · Read-only

Suggest worker professions from the OKPDTR classifier for partial input. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to autocomplete a value from the directory. Use dadata_okpdtr_profession_find for an exact code.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Name or part of the code to search. Example: водитель.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `filters` (`array`, optional): Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].

Example input: `{"query":"<query>"}`

### `dadata_oktmo_find`

Find OKTMO Municipality by Code · Read-only

Find a Russian municipality in the OKTMO classifier by its exact code. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Data has the OKTMO code, area and subarea names and types. Use this to decode an OKTMO code.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): OKTMO code (8 or 11 digits). Example: 54623425.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_okved2_find`

Find OKVED Activity Codes by Code · Read-only

Find one entry of the OKVED Activity Codes directory by its exact OKVED2 code. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this when the code is known. Use dadata_okved2_suggest for text.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Exact OKVED2 code. Example: 62.01.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_okved2_suggest`

Suggest OKVED Activity Codes · Read-only

Suggest OKVED2 economic activity codes by name or code for partial input. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to autocomplete a value from the directory. Use dadata_okved2_find for an exact code.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Name or part of the code to search. Example: программ.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `filters` (`array`, optional): Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].

Example input: `{"query":"<query>"}`

### `dadata_party_affiliated_find`

Find Affiliated Companies · Read-only

Find Russian companies where a person or company, given by INN, is a founder or a manager. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to map a person's or company's affiliations. Use dadata_party_find to look up the company itself.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): INN of the founder or manager (a person's 12-digit or a company's 10-digit INN). Example: 7736207543.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 300. Example: 5.
- `scope` (`array`, optional): Where to search: FOUNDERS, MANAGERS or both (the default). Example: ["FOUNDERS"]

Example input: `{"query":"<query>"}`

### `dadata_party_by_find`

Find Belarus Company by UNP · Read-only

Find a Belarusian company by its exact UNP (taxpayer number). Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this when the UNP is known. Use dadata_party_by_suggest for names.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): UNP of the company. Example: 690328165.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_party_by_suggest`

Suggest Belarus Companies · Read-only

Suggest companies registered in Belarus for a name or UNP (taxpayer number). Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this for Belarusian companies. Use dadata_party_suggest for Russia and dadata_party_kz_suggest for Kazakhstan.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Company name or UNP. Example: альфа.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `filters` (`array`, optional): Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].

Example input: `{"query":"<query>"}`

### `dadata_party_find`

Find Russian Company by INN or OGRN · Read-only

Find a Russian company or individual entrepreneur by exact INN, INN/KPP or OGRN. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. A company with branches returns several items, head office first. Use this to get registry details for a known tax number. Use dadata_party_suggest for names or partial input.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): INN, INN/KPP (separated by a slash) or OGRN. Example: 7707083893.
- `branch_type` (`string`, optional): Return only the head office (MAIN) or only branches (BRANCH). Example: MAIN. One of: `MAIN`, `BRANCH`.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 300. Example: 5.
- `kpp` (`string`, optional): KPP of a specific branch to return. Example: 540602001.
- `status` (`array`, optional): Limit to these statuses: ACTIVE, LIQUIDATING, LIQUIDATED, BANKRUPT, REORGANIZING. Example: ["ACTIVE"]
- `type` (`string`, optional): Limit to legal entities (LEGAL) or individual entrepreneurs (INDIVIDUAL). Example: LEGAL. One of: `LEGAL`, `INDIVIDUAL`.

Example input: `{"query":"<query>"}`

### `dadata_party_kz_find`

Find Kazakhstan Company by BIN · Read-only

Find a Kazakh company by its exact BIN (business identification number). Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this when the BIN is known. Use dadata_party_kz_suggest for names.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): BIN of the company. Example: 140440031745.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_party_kz_suggest`

Suggest Kazakhstan Companies · Read-only

Suggest companies registered in Kazakhstan for a name or BIN. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this for Kazakh companies. Use dadata_party_suggest for Russia.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Company name or BIN. Example: онлайн.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `filters` (`array`, optional): Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].

Example input: `{"query":"<query>"}`

### `dadata_party_suggest`

Suggest Russian Companies · Read-only

Suggest Russian companies and individual entrepreneurs from the EGRUL/EGRIP registers for a name, INN, OGRN, address or manager name. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Data includes INN, KPP, OGRN, names, legal form, status, OKVED, manager, address and branch type. Use this to autocomplete a company typed by a person. Use dadata_party_find for an exact INN or OGRN.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Company name, INN, OGRN, address or manager name, up to 300 characters. Example: сбербанк.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `locations` (`array`, optional): Limit results to these parent areas, as a list of objects such as {"region": "москва"}, {"kladr_id": "7700000000000"}, {"fias_id": "..."} or {"country": "*"} for all countries. At most 10 objects. Example: [{"region": "москва"}]
- `locations_boost` (`array`, optional): Rank results from these cities first, as a list of objects with a kladr_id, e.g. [{"kladr_id": "77"}]. At most 10 objects. Example: [{"kladr_id": "77"}]
- `okved` (`array`, optional): Limit to these OKVED activity codes. Example: ["64.19"]
- `status` (`array`, optional): Limit to these statuses: ACTIVE, LIQUIDATING, LIQUIDATED, BANKRUPT, REORGANIZING. Example: ["ACTIVE"]
- `type` (`string`, optional): Limit to legal entities (LEGAL) or individual entrepreneurs (INDIVIDUAL). Example: LEGAL. One of: `LEGAL`, `INDIVIDUAL`.

Example input: `{"query":"<query>"}`

### `dadata_postal_unit_find`

Find Post Office by Postal Code · Read-only

Find a Russian Post office by its exact six-digit postal code. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this when the postal code is known. Use dadata_postal_unit_geolocate to search by coordinates.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Six-digit postal code. Example: 127642.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.

Example input: `{"query":"<query>"}`

### `dadata_postal_unit_geolocate`

Find Post Offices Near Coordinates · Read-only

Find the Russian Post offices nearest to a latitude and longitude, nearest first. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to find the closest post office to a point.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `lat` (`number`, required): Latitude in decimal degrees. Example: 55.878.
- `lon` (`number`, required): Longitude in decimal degrees. Example: 37.653.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `filters` (`array`, optional): Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].
- `radius_meters` (`integer`, optional): Search radius in meters. Defaults to 100, maximum 1000. Example: 1000.

Example input: `{"lat":55.878,"lon":37.653}`

### `dadata_postal_unit_suggest`

Suggest Post Offices · Read-only

Suggest Russian Post offices for a postal code or address. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Data has postal code, address, coordinates, type, schedule and is_closed. Use this to find a post office. Use dadata_postal_unit_find for an exact postal code.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Postal code or post office address. Example: дежнева 2а.
- `count` (`integer`, optional): Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
- `filters` (`array`, optional): Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].

Example input: `{"query":"<query>"}`

## Related

Other Analytics connectors ([all 177](/agentkit/connectors/?category=analytics)):

- [Google Sheets](/agentkit/connectors/googlesheets/): Scalekit connector, OAuth, 48 tools
- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [AWS Redshift](/agentkit/connectors/redshift/): Scalekit connector, Trusted identity provider, 10 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
