Stable /api/currencies

Currency selector

Choose a currency with its ISO code and native symbol, sourced from the World currency endpoint.

ISO 4217 codes Native symbols Search-ready labels 250 country mappings

Installation

Install once, use everywhere.

composer require nnjeim/world
php artisan world:install

React, Angular, and Vue consume the same Laravel API; no frontend package is required.

Playground

Live behavior and copy-ready code.

Currency selector

Connecting to the World API…

Live preview

Selected value

Loading…

component.blade.php 
Loading example…

API reference

Request only the fields you need.

GET /api/currencies?fields=code,symbol
Endpoint
/api/currencies
Fields used
id, name, code, symbol

Component contract

Props

NameTypeDefaultDescription
name string currency_id Submitted form-field name.
value number|null null Initially selected currency ID.
showSymbol boolean true Includes the native currency symbol.
disabled boolean false Prevents selection changes.

Events

change Currency

Emitted after a currency is selected.

loading boolean

Reports API loading state.

error Error

Reports an unavailable or invalid response.

Validation guidance

  • Submit the numeric currency ID.
  • Use the currency code for external integrations.
  • Store monetary values separately from presentation symbols.

Accessibility checklist

  • ✓Do not use a symbol as the only currency label.
  • ✓Include both the currency name and ISO code.
  • ✓Expose loading and failure states.
  • ✓Keep option text unambiguous.