CQ Contest sites: CQ WW CQ WPX CQ WW RTTY CQ WPX RTTY CQ 160 CQ VHF
CQ Logo

CQ World Wide DX Contest

Score Database REST API Reference

A set of REST APIs has been created to enable software applications to access the score database. Only score records are supported at this time.

All requests are type GET and do not require authentication. They return content type application/json. Return response class is Status 200 for OK and Status 400 for error. Status message may contain information about the error detected.

Records API

Retrieve record score for given mode, category, and geo.

http://cqww.com/api/get/<request>/<mode>/<category>/<geo>

<request> Required. Must be "record"

<mode> Required. Must be "ph" or "cw" (use "rtty" on cqwwrtty.com)

<category> Optional. Category for filter (see category list below for accepted values). If blank, defaults to multi-operator multi-transmitter. Asterisk (*) can be used for wild card.

<geo> Optional. Blank or "world", 3 letter continent indicator, or country prefix.

Examples:

http://cqww.com/api/get/record/cw/sh%20all/w1 Get record for CW, single operator, high power, all bands, for W1 area.

http://cqww.com/api/get/record/ph/*40*/eur Get record for CW, 40 meter single band, for Europe.

Geo List

Retrieve list of available geo strings for filters and their display name. Can be world, continent, or country.

http://cqww.com/api/get/<request>/

<request> Required. Must be "geolist"

Example:

http://cqww.com/api/get/geolist Get list of all geo strings that will be accepted and their display name.

Category List

Retrieve list of available categories for filters.

http://cqww.com/api/get/<request>/

<request> Required. Must be "catlist"

Example:

http://cqww.com/api/get/catlist Get list of all category strings that will be accepted and their display name.

Notes

The same API calls may be used for CQ WW RTTY at the cqwwrtty.com web site. Use mode "rtty".
http://cqwwrtty.com/api/get/<request>/rtty/<category>/<geo>

All APIs are provided as is and without support.

 

Copyright © 2008-2017 World Wide Radio Operators Foundation. All Rights Reserved.