The latest articles on DEV Community by Sujip Thapa (@sudiptpa). https://dev.to/sudiptpa https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F505551%2F789d6c35-279e-426d-9bba-863639ae45b7.jpeg https://dev.to/sudiptpa en Sujip Thapa Sat, 21 Feb 2026 08:34:40 +0000 https://dev.to/sudiptpa/laravel-12-ip-intelligence-with-a-modern-ipstack-service-layer-sudiptpaipstack-sudiptpaguid-2b07 https://dev.to/sudiptpa/laravel-12-ip-intelligence-with-a-modern-ipstack-service-layer-sudiptpaipstack-sudiptpaguid-2b07 <p>I built an <code>IpstackService</code> in Laravel 12 powered by <code>sudiptpa/ipstack</code>, a modern PHP library for typed IP intelligence workflows and production-ready integration patterns.</p> <p>Full deep-dive tutorial is here:<br><br> 👉 <a href="https://sujipthapa.com/blog/ipstack-laravel-integration" rel="noopener noreferrer">https://sujipthapa.com/blog/ipstack-laravel-integration</a></p> <h2> Why this implementation matters </h2> <p>This was not a package demo. I implemented a full feature with:</p> <ul> <li>Web + API verification endpoints</li> <li>Service-layer architecture around <code>IpstackService</code> </li> <li>Request traceability via <code>sudiptpa/guid</code> </li> <li>Verification persistence for audit/observability</li> <li>Free-plan-safe behavior for real-world reliability</li> </ul> <h2> Stack used </h2> <ul> <li><p><a href="https://packagist.org/packages/sudiptpa/ipstack" rel="noopener noreferrer"><code>sudiptpa/ipstack</code></a><br><br> Modern, PSR-friendly PHP library for IPStack lookups (<code>single</code>, <code>requester</code>, <code>optimized</code>, <code>bulk</code>).</p></li> <li><p><a href="https://packagist.org/packages/sudiptpa/guid" rel="noopener noreferrer"><code>sudiptpa/guid</code></a><br><br> Lightweight GUID generation for request-level trace IDs.</p></li> </ul> <h2> What I shipped in Laravel 12 </h2> <h3> 1. Service-first design </h3> <p>A dedicated <code>IpstackService</code> handles all lookup workflows:</p> <ul> <li>Single lookup</li> <li>Requester lookup (<code>/check</code>)</li> <li>Optimized lookup using options (<code>fields</code>, <code>language</code>, plan-safe behavior)</li> <li>Bulk lookup with graceful fallback</li> </ul> <h3> 2. Real-world free plan handling </h3> <p>Two practical issues were handled in production style:</p> <ul> <li><p>Optimized lookup <code>400</code> on free plan<br><br> Fixed by using free-safe defaults unless advanced options are explicitly enabled.</p></li> <li><p>Bulk lookup <code>403</code> on free plan<br><br> Fixed by fallback to sequential single-IP lookups.</p></li> </ul> <h3> 3. Traceable verification records </h3> <p>Each request gets a GUID (<code>verification_guid</code>) and persists result/error context for easier debugging and support.</p> <h2> Endpoints implemented </h2> <p><strong>Web</strong></p> <ul> <li><code>GET /ip-verifications</code></li> <li><code>POST /ip-verifications</code></li> <li><code>POST /ip-verifications/requester</code></li> <li><code>POST /ip-verifications/optimized</code></li> <li><code>POST /ip-verifications/bulk</code></li> </ul> <p><strong>API</strong></p> <ul> <li><code>POST /api/ip-verifications</code></li> <li><code>POST /api/ip-verifications/requester</code></li> <li><code>POST /api/ip-verifications/optimized</code></li> <li><code>POST /api/ip-verifications/bulk</code></li> </ul> <h2> Result </h2> <p>The outcome is a robust Laravel 12 IP intelligence feature using a modern PHP IPStack client, with practical reliability improvements for real plan constraints.</p> <p>Read the full technical tutorial, code structure, and implementation walkthrough:<br><br> 👉 <a href="https://sujipthapa.com/blog/ipstack-laravel-integration" rel="noopener noreferrer">https://sujipthapa.com/blog/ipstack-laravel-integration</a><br> </p> <div class="highlight js-code-highlight"> <pre class="highlight plaintext"><code>`` </code></pre> </div> laravel php api geolocation