Resources

SOTA currently provides endpoints for following data:



List Associations

List all SOTA associations

GET  /Association

Parameters

None

Example Response

Status: 200 OK

[
  {
    "Id": 1,
    "AssociationName": "England",
    "AssociationCode": "G",
    "Manager": "Jimmy",
    "AssociationManagerCallsign": "M0HGY",
    "ActiveFrom": "2002-03-02T00:00:00"
  },
  {
    "Id": 2,
    "AssociationName": "Wales",
    "AssociationCode": "GW",
    "Manager": "Roger",
    "AssociationManagerCallsign": "MW0IDX",
    "ActiveFrom": "2002-03-02T00:00:00"
  }...
]



Get a single Association with a list of Regions

GET  /Association/{AssociationCode}

Parameters

Name Type Description
AssociationCode string

This is the standard SOTA prefix for the desired association.

Example: For France, submit 'F', for Spain (Catalunya) submit 'EA3'

Example Response

 
 Status: 200 OK

{

  "Id":4,
  "AssociationName":"Isle Of Man",
  "AssociationCode":"GD",
  "Manager":"John",
  "AssociationManagerCallsign":"GD0NFN",
  "ActiveFrom":"2002-06-01T00:00:00",
  "Regions:"
  [
      {
        "AssociationCode":"G",
        "RegionCode":"TW",
        "RegionManagerCallsign":"G4OBK",
        "RegionName":"Tees to the Wash",
        "Manager":"Phil Catterall",
        "Summits":5,
        "Notes":" ... "
       }
       {
          ...
        }
     ]
}



Get a single Region with list of Summits

GET  /Region/{AssociationCode}/{RegionCode}

Parameters

Name Type Description
AssociationCode string

This is the standard SOTA prefix for the desired association.

Example: For France, submit 'F', for Spain (Catalunya) submit 'EA3'

RegionCode string

A standard region prefix being the first part of the summit code.

Example: CE for Central England.

Response

  
 Status: 200 OK

{
  "Region":
    {
        "AssociationCode":null,
        "RegionCode":"CE",
        "RegionManagerCallsign":"G4ERP",
        "RegionName":"Central England",
        "Manager":"Richard Marshall",
        "Summits":0,
        "Notes":"This is the largest Region of the\nEnglish Association but has only five eligible summits ...",
        },
        "Summits":
        [
          {
            "SummitId":1259,
            "SummitCode":"G/CE-001",
            "Name":"Cleeve Hill",
            "ShortCode":null,
            "AltM":330,
            "AltFt":0,
            "GridRef1":null,
            "GridRef2":null,
            "Notes":null,
            "Longitude":null,
            "Latitude":null,
            "Points":1,
            "RegionCode":null
          },

          ...

      ]

}



Get a single Summit

GET  /Summit/{AssoicationCode}/{SummitCode}

Parameters

Name Type Description
AssociationCode string

This is the standard SOTA prefix for the desired association.

Example: For France, submit 'F', for Spain (Catalunya) submit 'EA3'

SummitCode string

A standard SOTA Summit Code of the form: 'CE-001'

Response

 Status: 200 OK

{
  "SummitId":13532,
  "SummitCode":"HB/JU-001",
  "Name":"Mont Raimeux",
  "ShortCode":"JU-001",
  "AltM":1302,
  "AltFt":4272,
  "GridRef1":"7.4284",
  "GridRef2":"47.3070",
  "Notes":"",
  "Longitude":7.4284,
  "Latitude":47.307,
  "Points":2,
  "RegionCode":"JU"
}



Get latest spots

GET  /spot/{n}/latest

Parameters

Name Type Description
n integer

Returns "N" number of latest spots.

Example: /spot/10/latest will return latest 10 spots

Response

 Status: 200 OK

{
  "Id": 48228,
  "TimeStamp": "2017-01-09T21:18:25.75",
  "AssociationCode": "W0C",
  "Callsign": "RBNHOLE",
  "ActivatorCallsign": "W0CP",
  "ActivatorName": "Walton",
  "Frequency": "10.113",
  "Mode": "cw",
  "Comments": "*[RBNHole] at NO1D 22 WPM 10 dB SNR",
  "SummitCode": "FR-062",
  "SummitDetails": "Mount Bailey, 2770m, 4 Point(s)"
}

...



Get spots by hour

GET  /spot/{hour}/hours

Parameters

Name Type Description
hour integer

Returns spots for specified hours.

Example: /spot/10/hours will return spots from past 10 hours

Response

 Status: 200 OK

{
  "Id": 48228,
  "TimeStamp": "2017-01-09T21:18:25.75",
  "AssociationCode": "W0C",
  "Callsign": "RBNHOLE",
  "ActivatorCallsign": "W0CP",
  "ActivatorName": "Walton",
  "Frequency": "10.113",
  "Mode": "cw",
  "Comments": "*[RBNHole] at NO1D 22 WPM 10 dB SNR",
  "SummitCode": "FR-062",
  "SummitDetails": "Mount Bailey, 2770m, 4 Point(s)"
}

...



Get latest alerts

GET  /alert/{n}/latest

Parameters

Name Type Description
n integer

Returns "n" latest alerts.

Example: /alert/10/latest will return 10 latest alerts

Response

 Status: 200 OK

{
  "TimeStamp": "2016-05-02T12:18:52",
  "DateActivated": "2026-05-02T14:00:00",
  "AssociationCode": "HB",
  "SummitCode": "HB/BL-001",
  "SummitDetails": "Hinteri Egg,1169M (3834F), 2",
  "PosterCallsign": "HB9BIN/P",
  "ActivatingCallsign": "HB9BIN/P",
  "ActivatorName": "Juerg",
  "Frequency": "7-cw,14-cw",
  "Comments": null
}

...



Get latest alerts by hour

GET  /alert/{hour}/hours

Parameters

Name Type Description
hour integer

Returns alerts for specified hour.

Example: /alert/10/hours will return alerts from last 10 hours

Response

 Status: 200 OK

{
  "TimeStamp": "2016-05-02T12:18:52",
  "DateActivated": "2026-05-02T14:00:00",
  "AssociationCode": "HB",
  "SummitCode": "HB/BL-001",
  "SummitDetails": "Hinteri Egg,1169M (3834F), 2",
  "PosterCallsign": "HB9BIN/P",
  "ActivatingCallsign": "HB9BIN/P",
  "ActivatorName": "Juerg",
  "Frequency": "7-cw,14-cw",
  "Comments": null
}

...