Get country data

Overview

Returns the full detail of one country: names, ISO codes, calling code, currency and flag emoji. Same payload as the removed POST /api/v1/utility/country, now resolved from the path instead of the request body.

Controller: App\Http\Controllers\Api\V1\Public\CountryController::show()
Route name: api.v1.public.countries.show

Authentication

Type: None (public endpoint)
Additional middleware: throttle:public. See docs/api/README.md §14.

Request

Method: GET
Path: /api/v1/public/countries/{code}

Path parameters

Parameter	Type	Description
`{code}`	`string(2)`	ISO 3166-1 alpha-2 country code. Case-insensitive: uppercased server-side. Constrained by the route to two letters (`[A-Za-z]{2}`); a request that does not match this shape at all does not reach the controller

Example request

Response `200 OK`

{
  "success": true,
  "status": "success",
  "message": "OK",
  "data": {
    "name": "Italy",
    "official_name": "Italian Republic",
    "native_name": "Italia",
    "native_official_name": "Repubblica italiana",
    "iso_3166_1_alpha2": "IT",
    "iso_3166_1_alpha3": "ITA",
    "calling_code": "39",
    "currency": "EUR",
    "emoji": "🇮🇹"
  }
}

Response fields

Field	Type	Nullable	Always present	Description
`data.name`	`string`	No	Yes	English name
`data.official_name`	`string`	No	Yes	English official name
`data.native_name`	`string`	No	Yes	Name in the country's own language
`data.native_official_name`	`string`	No	Yes	Official name in the country's own language
`data.iso_3166_1_alpha2`	`string`	No	Yes	Two-letter code
`data.iso_3166_1_alpha3`	`string`	No	Yes	Three-letter code
`data.calling_code`	`string`	No	Yes	International dialling prefix, without `+`
`data.currency`	`string`	No	Yes	ISO 4217 code
`data.emoji`	`string`	No	Yes	Flag emoji

Errors

`404 Not Found` — code not recognised

Two characters that are not an assigned ISO code, for example ZZ. Captured live:

{
  "success": false,
  "status": "error",
  "message": "Country not found"
}

`429 Too Many Requests`

Behind the dedicated public limiter (300 requests per minute, keyed by IP). No errors key.

{
  "success": false,
  "status": "error",
  "message": "Too many requests"
}

Notes

Data comes from a static country package, not the database. It does not change between deployments.

Replaces POST /api/v1/utility/country (removed; see docs/api/_archive/utility/POST_country.md). Unlike the removed endpoint, an invalid code (wrong length, not two letters) never reaches the controller at all - the route's where('code', '[A-Za-z]{2}') constraint answers the framework's default 404 for a route that doesn't match, before any validation runs.

Overview#

Authentication#

Request#

Path parameters#

Example request#

Response 200 OK#

Response fields#

Errors#

404 Not Found — code not recognised#

429 Too Many Requests#

Notes#

Request

Responses

Overview

Authentication

Request

Path parameters

Example request

Response `200 OK`

Response fields

Errors

`404 Not Found` — code not recognised

`429 Too Many Requests`

Notes