Other Contests: CQ WW CQ WPX CQ WW RTTY CQ WPX RTTY CQ 160 CQ VHF WW DIGI
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.

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.

Score

Retrieve final score by year and mode for a callsign (entry call or in operator list).

https://cqww.com/api/get/<request>/<mode>/<year>/<callsign>

<request> Required. Must be "score"

<mode> Required. Must be "ph" or "cw"

<year> Required. Between 1948 and latest results.

<callsign> Required. Callsign including any portable indicator.

Examples:

https://cqww.com/api/get/score/ph/2020/k5zd Get score for K5ZD from 2020 Phone.

https://cqww.com/api/get/score/cw/1992/k5zd/3 Get score for K5ZD/3 from 1993 CW.

Records

Retrieve record score for given mode, category, and region (call area, country, continent).

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

<request> Required. Must be "record"

<mode> Required. Must be "ph" or "cw"

<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. See Category List below.

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

Examples:

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

https://cqww.com/api/get/record/ph/*40*/eur Get record for SSB, all 40 meter single band categories, for Europe.

Geo List

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

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

<request> Required. Must be "geolist"

Example:

https://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.

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

<request> Required. Must be "catlist"

Example:

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

Club List

Retrieve list of active club names. Active clubs are those that have had 3 or more log entries within the previous 4 years.

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

<request> Required. Must be "clublist"

Example:

https://cqww.com/api/get/clublist Get list of all active club names and the region where they are located.

Raw Scores

Retrieve list of raw scores by category.

https://cqww.com/api/get/<request>/<mode>/category/<categoryname>

<request> Required. Must be "raw"

<mode> Required. Must be "ph" or "cw"

<categoryname> Required. Must be item from list of categories

Example:

http://cqww.com/api/get/raw/ph/category/sh+all Get list of all raw scores for single operator, all bands, high power (SH ALL).

Retrieve list of raw scores by callsign.

https://cqww.com/api/get/<request>/<mode>/callsign/<callsign>/

<request> Required. Must be "raw"

<mode> Required. Must be "ph" or "cw"

<callsign> Required. Must be complete callsign including any portables

Example:

http://cqww.com/api/get/raw/ph/callsign/w1aw Get list of all raw scores where callsign is found as entry call or in list of operators. May return more than one row if multiple entries found.

Notes

All APIs are provided as is and without support.

 

Copyright © 2008-2024 World Wide Radio Operators Foundation, Inc.. All Rights Reserved. | Privacy Policy