# DaData

Vet counterparties by INN without leaving the chat

Поиск компаний по ИНН/ОГРН, стандартизация адресов, банковские реквизиты, аффилированные компании

## How the agent works with DaData

The agent calls two DaData services at once. Through suggestions it looks companies up by INN, OGRN, BIC and corporate email, collects affiliated companies through founders and directors, pulls the OKVED and OKTMO reference books, resolves an address by coordinates and a city by IP. Through standardisation it parses addresses down to the apartment and brings phone numbers and personal names to a single format.

These two services are built differently, and the agent accounts for that. Suggestions answer a fuzzy string with a list of candidates: a query like OOO Romashka returns several, and taking the first one is not an option. So when vetting a counterparty the agent relies on an exact INN or OGRN, and flags a name match as a hypothesis. Standardisation, meanwhile, lives on a separate host and answers not with a list of candidates but with one parsed object: a string is either split into fields or marked as unparsed.

There is nothing to change in DaData: the service is a reference source, the agent sends a string and gets a parsed response back, creating and editing nothing. It writes only on your side — keeping the list of screened INNs and, on a regular run, reporting who has been liquidated, changed address or changed director since the last check. A registry status is presented as a registry record, not as proof that the company actually operates.

Usage is counted against the plan limits: 10,000 suggestion requests a day for free, while standardisation is billed separately at roughly 20 kopecks per address, so the agent sizes a bulk clean-up by volume up front and runs it in batches rather than firing the whole list at once. When the limit runs out or a company is not found in the registry, it says so directly instead of returning an empty line.

## Integration scenarios

### Vetting a counterparty by INN
The agent finds the company by INN or OGRN and shows its address, director, OKVED codes, registry status and registration date.

### Cleaning up addresses and bank details
The agent parses addresses down to the apartment, pulls the bank by BIC and brings phone numbers and personal names to a single format.

### Finding affiliated companies
The agent collects the companies tied to a counterparty through founders and directors and shows who else stands behind the same group of people.

### Regular portfolio screening
The agent runs through your list of INNs on a schedule and reports who has been liquidated, changed address or changed director since the last check.

### Who is behind an email
The agent looks a company up by its corporate email or the domain from a letter and shows who you are really writing to, INN and address included.

### OKVED and OKTMO decoded
The agent pulls the OKVED and OKTMO reference books and explains in plain words what the counterparty does on paper and which municipality it belongs to.

## How to connect

**Before you connect**

- The free suggestions limit is 10,000 requests a day
- Paid Standardisation if you need clean addresses and bank details

### Register at dadata.ru
The keys appear only after you follow the link from the confirmation email. Registration is free and suggestions work right away.

### Open your profile at dadata.ru/profile/#info
The API key is generated automatically and sits on that page. Copy it in full — it unlocks lookups by tax ID and company registration number.

## FAQ

### How do I connect DaData?
With two keys from your profile: sign up at dadata.ru, confirm your email and copy the API key and the secret key from dadata.ru/profile/#info. Both fields are required — the secret one is what address and bank detail standardisation needs.

### What can the agent look up?
Search and suggestions by INN, OGRN, BIC and corporate email, affiliated companies, standardisation of addresses, phone numbers and personal names, OKVED and OKTMO reference books, an address by coordinates and a city by IP.

### Does the agent change anything in DaData?
No. The service answers with reference data: the agent sends a string for lookup or standardisation and gets a parsed response back, creating and editing nothing in DaData.

### What are the limits?
Free access to suggestions is capped at 10,000 requests a day, and standardisation is billed separately at roughly 20 kopecks per address. Once the limit runs out, the agent says so right in the chat.

[Open DaData](https://dadata.ru/profile/#info)