The world,
ready for your UI.

Countries, states, cities, currencies, timezones, languages, and IP geolocation—packaged for Laravel and exposed through a clean API.

Explore the components Browse component docs

Terminal

$ composer require nnjeim/world:^2.0

Upgrading from 1.x? Read the 2.0 upgrade guide before updating. To stay on 1.x, keep ^1.1 and use the 1.x documentation.

GET /api/countries?search=rom

Response

200 OK

application/json

{
  "success": true,
  "message": "countries",
  "data": [
    {
      "id": 181,
      "name": "Romania"
    }
  ]
}

🌍

Coverage

250 countries

250

Countries and territories

5,000+

States and regions

Laravel 10–13

Broad framework support

MIT

Open source license

Live demo API

API activity

Calls served by this hosted API, including the examples on this site. Last 30 days, UTC.

Requests

—

Successful responses

—

P95 response time

—

Daily requests 30 days · UTC

Loading API activity…

Component library

Start with a country selector.

Try the component against the live World API, choose your framework, then copy the implementation into your application.

Country selector

Searchable · keyboard accessible · API-backed

Live preview Live API

Country

Choose the country for your profile.

Loading 250 countries…

Selected value Ready to submit

🇷🇴

Romania

ISO RO · ID 181

country-select.blade.php

Loading example…

One package, two interfaces

Use the facade or the API.

Keep geographic data close to your Laravel domain logic, or expose it to any frontend through configurable JSON endpoints.

Browse all usage examples

Countries

GET /api/countries

Search and filter 250 countries and territories.

States

GET /api/states

Resolve administrative regions by country.

Cities

GET /api/cities

Query cities by country or state.

Geolocation

GET /api/geolocate

Map an IP address to geographic context.

Build globally from day one

Add World to your next Laravel application.

View on Packagist

The world, ready for your UI.