The call sign look up service is an XML feed for remote applications to query amateur radio licensing databases. Updates are made to the database nightly.
Current Features
It is presently in beta form. It supports:
- Specific callsign lookup
- Searching by first and last name
- Canadian and American licensing
Future Features
Future features:
- International licensing
- Club associations
If there's something you'd like it to do, please indicate so here.
Accessing
The feed address is http://www.bcwireless.net/xmlrpc/callsign.php. Below is a table of GET or POST parameters:
Parameter name |
Description |
k |
A unique key for your application |
callsign |
An individual call sign to look up |
first_name |
A first name to search against |
last_name |
A last name to search against |
qrz |
An optional QRZ username and password, specified as username:password |
To use the feed, you will need an RemoteApplicationKey.
QRZ access
If you have a QRZ Online account you may specify your QRZ username and password to retrieve QRZ information about the callsign.
Returned data
The returned feed looks like this:
<results>
<database>
<lastupdated>2008-07-09 01:19:17</lastupdated>
<totalrows>64755</totalrows>
<totalsize>6322888</totalsize>
<foo>42</foo>
</database>
<found>true</found>
<resultcount>1</resultcount>
<records>
<record idx="60153">
<callsign>VE7FOOBAR</callsign>
<first_name>John</first_name>
<last_name>Smith</last_name>
<street_1>1234 Some Street</street_1>
<city>Some City</city>
<postal>H0H 0H0</postal>
<province>BC</province>
<country>Canada</country>
<qual_basic>true</qual_basic>
<qual_advanced>false</qual_advanced>
<qual_morse>true</qual_morse>
<club>
<name>The Club Name</name>
<name_2></name_2>
<address>1234 Some Street</address>
<city>City</city>
<province>BC</province>
<postal>H0H 0H0</postal>
<country>Canada</country>
</club>
<irlp>
<node id="1234">
<owner>VE?ABC</owner>
<city>Some City</city>
<country>Name of Country</country>
<status>IDLE</status>
<latitude></latitude>
<longitude></longitude>
<lastupdate_t>1217359270</lastupdate_t>
<lastupdate_r>Tue, 29 Jul 2008 12:21:10 -0700</lastupdate_r>
<frequency>123.444</frequency>
<offset>0.600</offset>
<pl></pl>
<avrs_status>O</avrs_status>
</node>
</irlp>
<qrz serial="1234">
<email>email@address</email>
<website>http://www.website.com</website>
<latitude></latitude>
<longitude></longitude>
</qrz>
</record>
</records>
</results>
The database element includes information about when the database was last updated, and total size.
The found element indicates whether the query was succesful or not. Errors are returned in a seperate errors element.
Each record is returned within a record element.
Getting help
Contact MatthewAsham or drop by our IrcChannel
