Skip to content callsign and DXCC entity lookup client.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


QrzEx is an Elixir implementation of a client. It enables applications to make radio callsign lookups and DXCC entity lookups using the XML API. The client takes care of converting the XML responses into native Elixir maps for easy consumption.


If available in Hex, the package can be installed by adding qrz_ex to your list of dependencies in mix.exs:

def deps do
    {:qrz_ex, "~> 0.1.0"}


To use the API you must first retrieve a session key. This requires that you have a user already. If you do not have a subscription you will still be able to use the API but will have limited information returned on your queries and will be limited to 100 requests per day. For more information on the subscriptions available, consult the QRZ Subscriptions.


This will response like this:

   count: 11,
   error: nil,
   expiration: "non-subscriber",
   key: "..."

Logging in provides you with a key which represents your logged in session. The expiration of a session key is presently unknown and not clearly documented in the QRZ XML API documentation. Once you have this key you can make other API calls:

QrzEx.lookup_callsign("SESSION_KEY", "W1AW")
QrzEx.fetch_dxcc_entities("SESSION_KEY", 291)
QrzEx.fetch_dxcc_entities("SESSION_KEY", "W1AW")

The last example defaults to fetching all DXCC entities. Please use this sparingly so as to not overburden the servers.


Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at

You can’t perform that action at this time.