(Proposed ADIF Version 3.0.6, updated 2017/07/30, annotated with changes from the previous release: green for additions, and red for deletions)

Amateur Data Interchange Format (ADIF) Specification

Table of Contents

1. Introduction
   1. Background
   2. Development
2. Policies
   1. Upward Compatibility
   2. Deprecation
3. Data Types, Enumerations, and Fields
   1. Data Types
   2. Enumerations
      1. Ant_Path
      2. ARRL Section Names
      3. Awards (Deprecatedimport-only)
      4. Bands
      5. Contests IDs
      6. Continent
      7. Credit
      8. DXCC Entity Code Enumeration
      9. Modes
      10. Submodes
      11. Primary Administrative Subdivisions
      12. Secondary Administrative Subdivisions
      13. Propagation Modes
      14. QSL Medium
      15. QSL Rcvd
      16. QSL Sent
      17. QSL Via
      18. QSO Complete
      19. QSO Upload Status
      20. Region
      21. Sponsored Award
   3. Fields
      1. ADIF-defined Fields
         1. Header Fields
            
            
            ADIF_VER, 

            CREATED_TIMESTAMP, 

            PROGRAMID,  PROGRAMVERSION, 

            USERDEFn
         2. QSO Fields
            
            
            ADDRESS,  ADDRESS_INTL,  AGE,  A_INDEX,  ANT_AZ,  ANT_EL,  ANT_PATH,  ARRL_SECT,  AWARD_GRANTED,  AWARD_SUBMITTED, 

            BAND,  BAND_RX, 

            CALL,  CHECK,  CLASS,  CLUBLOG_QSO_UPLOAD_DATE,  CLUBLOG_QSO_UPLOAD_STATUS,  CNTY,  COMMENT,  COMMENT_INTL,  CONT,  CONTACTED_OP,  CONTEST_ID,  COUNTRY,  COUNTRY_INTL,  CQZ,  CREDIT_SUBMITTED,  CREDIT_GRANTED, 

            DARC_DOK,  DISTANCE,  DXCC, 

            EMAIL,  EQ_CALL,  EQSL_QSLRDATE,  EQSL_QSLSDATE,  EQSL_QSL_RCVD,  EQSL_QSL_SENT, 

            FISTS,  FISTS_CC,  FORCE_INIT,  FREQ,  FREQ_RX, 

            GRIDSQUARE,  GUEST_OP, 

            HRDLOG_QSO_UPLOAD_DATE,  HRDLOG_QSO_UPLOAD_STATUS, 

            IOTA,  IOTA_ISLAND_ID,  ITUZ, 

            K_INDEX, 

            LAT,  LON,  LOTW_QSLRDATE,  LOTW_QSLSDATE,  LOTW_QSL_RCVD,  LOTW_QSL_SENT, 

            MAX_BURSTS,  MODE,  MS_SHOWER,  MY_ANTENNA,  MY_ANTENNA_INTL,  MY_CITY,  MY_CITY_INTL,  MY_CNTY,  MY_COUNTRY,  MY_COUNTRY_INTL,  MY_CQ_ZONE,  MY_DXCC,  MY_FISTS,  MY_GRIDSQUARE,  MY_IOTA,  MY_IOTA_ISLAND_ID,  MY_ITU_ZONE,  MY_LAT,  MY_LON,  MY_NAME,  MY_NAME_INTL,  MY_POSTAL_CODE,  MY_POSTAL_CODE_INTL,  MY_RIG,  MY_RIG_INTL,  MY_SIG,  MY_SIG_INTL,  MY_SIG_INFO,  MY_SIG_INFO_INTL,  MY_SOTA_REF,  MY_STATE,  MY_STREET,  MY_STREET_INTL,  MY_USACA_COUNTIES,  MY_VUCC_GRIDS, 

            NAME,  NAME_INTL,  NOTES,  NOTES_INTL,  NR_BURSTS,  NR_PINGS, 

            OPERATOR,  OWNER_CALLSIGN, 

            PFX,  PRECEDENCE,  PROP_MODE,  PUBLIC_KEY, 

            QRZCOM_QSO_UPLOAD_DATE,  QRZCOM_QSO_UPLOAD_STATUS,  QSLMSG,  QSLMSG_INTL,  QSLRDATE,  QSLSDATE,  QSL_RCVD,  QSL_RCVD_VIA,  QSL_SENT,  QSL_SENT_VIA,  QSL_VIA,  QSO_COMPLETE,  QSO_DATE,  QSO_DATE_OFF,  QSO_RANDOM,  QTH,  QTH_INTL, 

            REGION,  RIG,  RIG_INTL,  RST_RCVD,  RST_SENT,  RX_PWR, 

            SAT_MODE,  SAT_NAME,  SFI,  SIG,  SIG_INTL,  SIG_INFO,  SIG_INFO_INTL,  SILENT_KEY,  SKCC,  SOTA_REF,  SRX,  SRX_STRING,  STATE,  STATION_CALLSIGN,  STX,  STX_STRING,  SUBMODE,  SWL, 

            TEN_TEN,  TIME_OFF,  TIME_ON,  TX_PWR, 

            UKSMG,  USACA_COUNTIES, 

            VE_PROV,  VUCC_GRIDS, 

            WEB
      2. Application-defined Fields
      3. User-defined Fields
4. File Formats
   1. ADI file format
   2. ADX file format
5. ADIF Resources
   1. ADX Schemas
   2. Implementation Notes
6. External Links

I. Introduction

I.A. Background

Ever since software has become a part of amateur radio, there have been as many data formats as there have been ham radio software programmers.  Hams have struggled with converting data among various formats.  In early 1996 KK7A promoted the idea of a standard for exchange of ham data, and an iInternet reflector was set up for discussing such a standard.  Ray WF1B and Dennis WN4AZY, publishers of commercial ham radio software, took the best suggestions from this discussion and proposed the Amateur Data Interface Format (ADIF), which Ray introduced as ADIF 1.0 at the 1996 Dayton Hamvention.  Within a year, this standard was adopted by most software publishers.

Starting In 2002, ADIF 2.0.0 initiated a period of upward-compatible expansion during which new data types, formal enumerations, additional fields, and enumeration values were added.

During 2010, the need to support international characters led to this proposal to define a second file format (syntax) that would introduce international data types using Unicode encoded with UTF-8, and that would employ XML syntax.  This second file format, referred to as ADX, references the same Data Types, Enumerations, and Fields as are referenced by the original ADIF file format, now referred to as ADI.

I.B. Development

If you would like to discuss the specification, request a change, or report errors, please join the ADIF Developers Group.

The ADIF specification is produced by the ADIF Developers Group, whichThe ADIF Developers Group produces the ADIF specification and is open to developers of logging software, web sites, amateur radio applications, and others who have a vested interest in the ADIF standard and who will actively participate in its definition, maintenance, and promotion.  Decisions are made by majority vote in the ADIF Voting group, with each application or service represented by exactly one ADIF Voting group member.

II. Policies

II.A. Upward Compatibility

From one version of ADIF to the next, Data Types, Enumerations, Fields, and Formats shall be upwardly compatible, meaning that an ADIF file compliant with ADIF version N will comply with any future ADIF version M where M>N.

II.B. Deprecation

Deprecated fields and enumeration values shall be accepted when importing an ADIF file, but shall not be emitted when exporting an ADIF file.

III. Data Types, Enumerations, and Fields

III.A. Data Types

Data Types and Data Type Indicators are case insensitive.

III.B. Enumerations

Enumeration values are case insensitive.

III.B.1 Ant Path Enumeration

III.B.2 ARRL Section Enumeration

III.B.3 Award Enumeration (import-only)

III.B.4 Band Enumeration

III.B.5 Contest ID Enumeration

III.B.6 Continent Enumeration

III.B.7 Credit Enumeration

III.B.8 DXCC Entity Code Enumeration

III.B.9 Mode Enumeration

III.B.10 Submode Enumeration

III.B.13 Propagation Mode Enumeration

III.B.11 Primary Administrative Subdivision Enumeration