Updated: 7/10/2022

Version: 22.7.10a

Effective: Varies - see dates below



What are the Delivery Methods?

Delivery options are how the member elect to receive the format above.  DigAlert offers many ways you can receive tickets.  Most members receive their tickets by email.  Below are options along with any associated costs.

List of Delivery Methods
  • Email 
  • Web Hook
  • WebTMS (Discontinued through DigAlert, see NorfieldDP.com for more information about a seamless integration with our ticket vendor)



What are Ticket Formats?

Ticket Formats are the exact specification that a ticket is delivered to utility members.  As a utility member you have the choice to choose the format that you would like to have delivered.  Any changes to formats must be approved by the Board of Directors and members are given as much notice as possible of any and all changes to Ticket Formats before changes go into effect.


Current List of Formats
  • Plain text format (Email only)
  • Plain text with EPR link (Email only)
  • HTML (default for new members)  (Email only)
  • JSON (Email, Web Hook) 
  • XML with arrays for members and shape points  (Email, Web hook)
  • XML with XSD and flat lists for members and shape points  (Email, Web hook)
Format Changes
  • 1/1/2023 - new mandatory format.  This format will be live starting January 1st, 2023.  Test tickets will be available for members no later than 11/1/2022.
    • Ticket type of DMGE (damage) will be added and used for tickets that are reporting a damage
    • Ticket type of EXPD (exposed) will be added and used for tickets that are reporting an exposed line
    • Ticket type of DMEX (damage/exposed) will be removed and no longer used
    • Ticket type of RTRN (return trip) will be added and used for any reason the excavator is requesting any or all members to respond to the job site for any reason other than requesting re-marks, no response, damage or exposed. This new ticket type will reset the legal notice requirement for the members to respond giving members time to respond back to the job site.  For example, “gate is now unlocked”.
    • New field used to identify the type of excavator requesting the ticket called “Type” will be added. Please see 2023 DigAlert Ticket Types, Headers & Explanations for complete list of possibilities.
    • New field called “Job Size” will be added and used to show how many square feet and square miles the job site contains
    • The Address, Street, Cross 1 and Cross 2 fields will be removed from the Location field and placed back into dedicated fields for each
    • New field called “Project ID” will be added for future use
    • New field called “Project Name” will be added for future use
    • New field called “Pavement Only” will be added and used to identify jobs that are doing pavement grinding only
    • New field called “Searchable tags” will be added and used to store system generated hashtags for faster searching, indexing and parsing of ticket information. Please see 2023 DigAlert Ticket Types, Headers & Explanations for complete list of possibilities.
  • 3/1/2019 - new mandatory format. This format will be live starting March 1st, 2019. Testing will be available for members on 1/1/2019
    • Complete re-format of entire output
    • Common format for all of California - DigAlert and USANorth811
  • 11/1/2017 - new mandatory format to comply with the new GC 4216. This format will be the only format available after 11/1/17.
    • Added a new field named Work Order "Wrk Order:" to the ticket
    • Added a new priority of "EMER" or "9" for emergency tickets
    • Added a category field to the header
    • Added a new field named "1Year:" for continual excavation tickets
    • Added a new field named "Response Required:" to indicate if the member is required to respond to the excavator
    • Added a new field named "Legal Date:" representing the date the ticket must be responded to by members that are required to respond to the excavator
    • Added a new field named "Legal Time:" representing the time the ticket must be responded to by members that are required to respond to the excavator
    • Added a new field named "View map at:" which will have a link to DigAlert's system allowing the members to view the map that DigAlert sent
    • Changed the "FAX:" field to "SMS:" which will be used for cell phone numbers instead of fax numbers
    • Removed the field "Grids:"
    • Expanded the field "Caller GPS" to a text field that will allow multiple lat/long points for use with Electronic Whitelining
  • 1/1/2016 - new fields were added under an optional format for members that choose to receive them
    • Added a new field named Work Order "Wrk Order:" to the ticket
    • Added a new priority of "EMER" or "9" for emergency tickets

Download the new format below or read about the changes, see specs and samples here → 2023 Plain Text Ticket Format Details


Downloadable Format Documents and Samples
  • January 1st 2023 mandatory format change documents & plain text samples

2023.1.1d_DigAlertFormatDocs.zip


  • March 1st 2019 mandatory format documents & samples

2019.3.1 DigAlert Format.zip