PHPackages codersstudio/dadata-api - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. codersstudio/dadata-api ActiveLibrary[API Development](/categories/api) codersstudio/dadata-api ======================= Laravel package for Dadata API - address suggestions, cleaning, company and bank data lookup 1.0(5y ago)017MITPHPCI failing Since Jun 26Pushed 3w ago1 watchersCompare [ Source](https://github.com/imjonos/laravel-dadata-api)[ Packagist](https://packagist.org/packages/codersstudio/dadata-api)[ Docs](https://github.com/imjonos/laravel-dadata-api)[ RSS](/packages/codersstudio-dadata-api/feed)WikiDiscussions master Synced 1w ago READMEChangelog (1)Dependencies (5)Versions (2)Used By (0) Laravel Dadata API ================== [](#laravel-dadata-api) Laravel package for working with [Dadata API](https://dadata.ru/) - address suggestions, data cleaning, company and bank information lookup. Features -------- [](#features) - Address suggestions with FIAS support - Address cleaning and standardization - Phone number cleaning - Company search by INN - Bank search by BIC/SWIFT - Delivery point IDs (CDEK, Boxberry, DPD) - Full DTO support for type-safe data handling Requirements ------------ [](#requirements) - PHP 8.3+ - Laravel 12.0+ - [imjonos/laravel-base-dto](https://github.com/imjonos/laravel-base-dto) package - Dadata account ([register](https://dadata.ru/)) Installation ------------ [](#installation) ``` composer require imjonos/laravel-dadata-api ``` ### Configuration [](#configuration) Publish the configuration file: ``` php artisan vendor:publish --tag=dadataapi.config ``` Add your Dadata credentials to `.env`: ``` DADATA_TOKEN=your_api_token DADATA_SECRET=your_secret_key ``` You can find your credentials in your [Dadata profile](https://dadata.ru/profile). Usage ----- [](#usage) ### Address Suggestions [](#address-suggestions) ``` use Nos\DadataApi\Facades\DadataApi; // Get city suggestions $collection = DadataApi::suggestCity('Москва'); foreach ($collection as $suggestion) { echo $suggestion->value; echo $suggestion->data->fiasId; } // Filter by country $collection = DadataApi::suggestCity('London', ['GB']); // Street suggestions (requires city FIAS ID) $collection = DadataApi::suggestStreet('Ленина', $cityFiasId); // House suggestions (requires street FIAS ID) $collection = DadataApi::suggestHouse('10', $streetFiasId); ``` ### Company Search [](#company-search) ``` use Nos\DadataApi\Facades\DadataApi; // Search company by INN $collection = DadataApi::suggestCompany('7707083893'); $company = $collection->first(); echo $company->value; // Company name echo $company->data->inn; echo $company->data->ogrn; ``` ### Bank Search [](#bank-search) ``` use Nos\DadataApi\Facades\DadataApi; $collection = DadataApi::suggestBank('Сбербанк'); $bank = $collection->first(); echo $bank->value; echo $bank->data->bic; echo $bank->data->swift; ``` ### Address Cleaning [](#address-cleaning) ``` use Nos\DadataApi\Facades\DadataApi; $address = DadataApi::cleanAddress('москва сухонская 11/-89'); echo $address->result; // г Москва, ул Сухонская, д 11, кв 89 echo $address->postalCode; // 127642 echo $address->geoLat; // 55.8783089 echo $address->geoLon; // 37.6537862 ``` ### Phone Cleaning [](#phone-cleaning) ``` use Nos\DadataApi\Facades\DadataApi; $phone = DadataApi::cleanPhone('8(495)123-45-67'); echo $phone->phone; // +7 495 123-45-67 echo $phone->countryCode; // +7 echo $phone->timezone; // UTC+3 ``` ### Delivery Points [](#delivery-points) ``` use Nos\DadataApi\Facades\DadataApi; // Get CDEK, Boxberry, DPD IDs by KLADR ID $collection = DadataApi::suggestDeliveryId('3100400100000'); $delivery = $collection->first(); echo $delivery->data->cdekId; echo $delivery->data->boxberryId; echo $delivery->data->dpdId; ``` Available Methods ----------------- [](#available-methods) All suggestion methods return `SuggestionCollection`: MethodParametersDescription`suggestCity``$query`, `$countryCodeISO`, `$count`City suggestions`suggestStreet``$query`, `$fiasId`, `$count`Street suggestions`suggestHouse``$query`, `$streetFiasId`, `$count`House suggestions`suggestCountry``$query`, `$count`Country suggestions`suggestAddress``$query`, `$fiasId?`General address search`suggestBank``$query`Bank search`suggestCompany``$inn`Company by INN`suggestDeliveryId``$kladrId`Delivery point IDs`suggestAddressById``$fiasId`Address by FIAS IDClean methods return DTO objects: MethodParametersReturns`cleanAddress``$address``AddressDTO``cleanPhone``$phone``PhoneDTO`DTO Classes ----------- [](#dto-classes) ### AddressDTO [](#addressdto) Represents cleaned address with all details: ``` $address->result; // Formatted address $address->postalCode; $address->region; $address->city; $address->street; $address->house; $address->flat; $address->geoLat; $address->geoLon; $address->fiasId; $address->qc; // Quality code ``` ### PhoneDTO [](#phonedto) Represents cleaned phone number: ``` $phone->phone; // Formatted phone $phone->countryCode; $phone->cityCode; $phone->provider; $phone->timezone; $phone->qc; // Quality code ``` ### SuggestionDTO [](#suggestiondto) Represents suggestion from search methods: ``` $suggestion->value; // Display value $suggestion->unrestrictedValue; // Full value $suggestion->data; // SuggestionDataDTO ``` ### SuggestionCollection [](#suggestioncollection) Collection of suggestions with utility methods: ``` $collection->count(); $collection->first(); $collection->map(fn($item) => ...); $collection->filter(fn($item) => ...); $collection->each(fn($item) => ...); ``` License ------- [](#license) MIT License. See [license.md](license.md) for more information. ### Health Score 35 — LowBetter than 80% of packages Maintenance62 Regular maintenance activity Popularity6 Limited adoption so far Community7 Small or concentrated contributor base Maturity55 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 2152d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/a691ecb149ac661add3a6229e3c545aaaa40bad4ae0fa9c0ad9464c79e86ff20?d=identicon)[Eugeny Nosenko](/maintainers/Eugeny%20Nosenko) --- Top Contributors [![al-cisc0](https://avatars.githubusercontent.com/u/59999501?v=4)](https://github.com/al-cisc0 "al-cisc0 (1 commits)") --- Tags laravelDadataApi ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/codersstudio-dadata-api/health.svg) ``` [![Health](https://phpackages.com/badges/codersstudio-dadata-api/health.svg)](https://phpackages.com/packages/codersstudio-dadata-api) ``` ### Alternatives [andreaselia/laravel-api-to-postman Generate a Postman collection automatically from your Laravel API 1.0k586.2k3](/packages/andreaselia-laravel-api-to-postman)[mollie/laravel-mollie Mollie API client wrapper for Laravel & Mollie Connect provider for Laravel Socialite 3624.1M28](/packages/mollie-laravel-mollie)[api-ecosystem-for-laravel/dingo-api A RESTful API package for the Laravel and Lumen frameworks. 3121.5M10](/packages/api-ecosystem-for-laravel-dingo-api)[essa/api-tool-kit set of tools to build an api with laravel 52680.5k](/packages/essa-api-tool-kit)[mll-lab/laravel-graphiql Easily integrate GraphiQL into your Laravel project 683.2M9](/packages/mll-lab-laravel-graphiql)[kirschbaum-development/laravel-openapi-validator Automatic OpenAPI validation for Laravel HTTP tests 581.1M5](/packages/kirschbaum-development-laravel-openapi-validator) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)