WARNING

This information contained within this page will become effective January 1st, 2023


Delivery Method(s): Email only

Updated: 7/7/2022

Version: 21.12.1a

Effective: Jan 1st 2023

Format Effective 1/1/2023

The following information will show the format programming details, sample of a new ticket and a sample of a Request Re-Marks ticket.


Warning for members parsing tickets

We DO NOT recommend using plain text email format to parse tickets.  If you are using a ticket management system and/or parsing ticket data, we recommend you using either JSON or XML formats.  For more information select the corresponding format from the menu to the left.

In order to avoid issues with parsing tickets, please follow these rules BEFORE making any code changes

  1. DO NOT code for data, only code for field names as the data changes from ticket to ticket. The field names are always followed by a colon ":". For example "Map Link:" is the field and everything that follows is data
  2. All fields will show all the time with these exceptions:
    1. "Re-Marks Required" - This field will only show when the ticket type is Request Re-Marks (REMK). When this field shows, it will list the facility types the excavator is requested to be re-marked.
    2. "Comments" - This field will NOT show on NEW tickets unless the ticket is a re-issued ticket. A re-issued ticket is a ticket that has been amended more than 99 times. This does not happen often.
  3. Map Link can be either http or https depending upon the server


WARNING for USA North811 members!

 

While every attempt to provide members with the most up to date and accurate information is made from DigAlert, we CANNOT guarantee the accuracy of any information for USANorth811 on this site. You should CONTACT USANORTH811 and verify all their information PRIOR to making any changes to their format.

 

Ticket Types Are Changing Too

See → 2023 DigAlert Ticket Types, Headers & Explanations for a detailed list of the new ticket types and priorities.



Format Specifications
********** #####X USAS MM/DD/YY HH:MM:SS X#########-##X XXXX XXXX XXXX XXXX
Ticket: X######### Rev: ##X Created: MM/DD/YY HH:MM User: ********(20)******** Chan: ***

Work Start: MM/DD/YY HH:MM Legal Start: MM/DD/YY HH:MM Expires: MM/DD/YY HH:MM
Response Required: X Priority: #
Re-marks Required: *************************(200)*********************************************
                 : **********************(Could Wrap)*****************************************

Excavator Information
Company: **************(40)********************* Type: *(4)*
Co Addr: **************(40)*********************
City   : ***********(30)************** State: ** Zip: #####-#### 
Created By: ***********(30)************** Language: *******(15)****
Office Phone: ###-###-#### ****** SMS/Cell: ###-###-####
Office Email: ****************************************(80)************************************

Site Contact: ***********(30)**************
Site Phone: ###-###-#### ****** Site SMS/Cell: ###-###-####
Site Email: ****************************************(80)************************************

Excavation Area
State: ** County: *****(15)****** Place: **************(40)****************** 
Zip: **************(30)************
Address: ***** Street: **************(40)******************
Cross 1: **************(40)****************** 
Cross 2: **************(40)****************** 
Location: THIS FIELD DOES NOT HAVE A PREDETERMINED MAXIMUM LENGTH.  PLEASE SET SQL TO TEXT.
		: THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG 1234567890 TIMES AND HASTILY RUNS INTO
        : THE CHICKEN COOP.  THIS FIELD DOES NOT HAVE A PREDETERMINED MAXIMUM LENGTH.
        : THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG 1234567890 TIMES AND HASTILY
        : RUNS INTO THE CHICKEN COOP.  THIS FIELD DOES NOT HAVE A PREDETERMINED
        : MAXIMUM LENGTH.  THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG 1234567890
        : TIMES AND HASTILY RUNS INTO THE CHICKEN COOP.
		: 
Searchable Tags: THIS FIELD DOES NOT HAVE A HAVE A PREDETERMINED MAXIMUM LENGTH.
		: PLEASE SET SQL TO TEXT.  EACH HASHTAG WILL HAVE THE '#' FOLLOWED BY LOWERCASE
		: WORDS TO SEARCH OR INDEX.  MULTIPLE HASHTAGS WILL BE SEPARATED BY A SPACE.
		: FOR A COMPLETE LIST OF POSSIBLE HASHTAGS SEE DOCS.DIGALERT.ORG
Job Size: sq-feet:##(9)#### sq-miles:###.#######

Delineated Method: ****************************(60)****************************
Work Type: ****************************************(80)************************************
Work For: **************(40)******************
Permit: **************(30)************ Job/Work Order: **************(30)************
Project ID: *****(15)******
Project Name: ****************************(65)*********************************
1 Year: X Boring: X Street/Sidewalk: X Vacuum: X  Explosives: X Pavement Only: X

Lat/Long
Center Generated (NAD83): ##.######/-###.###### ##.######/-###.######
           		: ##.######/-###.###### ##.######/-###.######
Excavator Provided: ##.######/-###.###### ##.######/-###.###### ##.######/-###.######
	          : ##.######/-###.###### ##.######/-###.###### ##.######/-###.######
        	  : ##.######/-###.###### ##.######/-###.###### ##.######/-###.######
	          : THIS FIELD DOES NOT HAVE A HAVE A PREDETERMINED MAXIMUM LENGTH.  
        	  : PLEASE SET SQL TO TEXT. EACH LINE WILL HAVE A MAXIMUM OF 3
	          : LAT/LONGS.

Map Link:
*****************************************(255)*******************************************

Comments:
THIS FIELD DOES NOT HAVE A PREDETERMINED MAXIMUM LENGTH.  PLEASE SET SQL TO TEXT
THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG 1234567890 TIMES AND HASTILY RUNS INTO
THE CHICKEN COOP. THIS FIELD DOES NOT HAVE A PREDETERMINED MAXIMUM LENGTH.  THE QUICK 
BROWN FOX JUMPS OVER THE LAZY DOG 1234567890 TIMES AND HASTILY RUNS INTO THE CHICKEN 
COOP. THIS FIELD DOES NOT HAVE A PREDETERMINED MAXIMUM LENGTH.  THE QUICK BROWN FOX
JUMPS OVER THE LAZY DOG 1234567890 TIMES AND HASTILY RUNS INTO THE CHICKEN COOP.

Members: 
MBR001 MBR020 MBR039 LONGMBR058    MBR077 MBR096 MBR115 LONGMBR134
MBR153 MBR172 MBR191 LONGMBR210    MBR229 MBR248 MBR267 LONGMBR286    MBR305
MBR324 MBR343 LONGMBR362    MBR381 MBR400 MBR419 LONGMBR438    MBR457

     (C) Copyright 2022 Underground Service Alert of Southern California
                          All rights reserved


Format Sample - New ticket (NO EPR LINK)
 
MBR001 00010A USAS 01/01/19 13:23:14 A121231234-01A NEW NORM POLY LREQ

Ticket: A121231234 Rev: 00A Created: 01/01/19 13:22 User: JSCHWILK  Chan: WEB
Work Start: 01/03/19 17:01 Legal Start: 01/03/19 17:01 Expires: 01/29/19 23:59
Response Required: Y Priority: 2

Excavator Information
Company: ABC COMPANY Type: CONT
Co Addr: 123 MAIN ST
City   : SOMEWHERE State: CA Zip: 12345-1234 
Created By: JIM SCHWILK Language: ENGLISH
Office Phone: 123-123-1234 x12345 SMS/Cell: 123-123-1234
Office Email: JIM@DOMAIN.COM

Site Contact: JAMES WINGATE
Site Phone: 123-123-1234 x12345 Site SMS/Cell: 123-123-1234
Site Email: JAMES@DOMAIN.COM

Excavation Area
State: CA County: LOS ANGELES Place: CARSON 
Zip: 90001,90002
Address: 12345 Street: MAIN ST
Cross 1: 1ST ST
Cross 2:
Location: SOME TEXT OF WHERE AT ADDRESS THE WORK IS
        : DOG IN YARD
Searchable Tags: #pipe_burst #microtrench #night_weekend
Job Size: sq-feet: 5700 sq-miles: 0.000204

Delineated Method: WHITE PAINT
Work Type: REPAIR AND REPLACE SOMETHING
Work For: JOES RESTAURANT
Permit: 123456789ABC Job/Work Order: AB123456
Project ID:  
Project Name: 
1 Year: N Boring: N Street/Sidewalk: Y Vacuum: Y Explosives: Y Pavement Only: N

Lat/Long
Center Generated (NAD83): ##.######/-###.###### ##.######/-###.######
            		: ##.######/-###.###### ##.######/-###.######
Excavator Provided: ##.######/-###.###### ##.######/-###.###### ##.######/-###.######
            	  : ##.######/-###.###### ##.######/-###.###### ##.######/-###.######
	          : ##.######/-###.###### ##.######/-###.###### ##.######/-###.######
        	  : THIS FIELD DOES NOT HAVE A HAVE A PREDETERMINED MAXIMUM LENGTH.  
	          : PLEASE SET SQL TO TEXT. EACH LINE WILL HAVE A MAXIMUM OF 3
        	  : LAT/LONGS.

Map Link:
https://somelink.doamin.com/linkinformationhereandthiscouldbealongstring

Members: 
MBR001 MBR020 MBR039 LONGMBR058    MBR077 MBR096 MBR115 LONGMBR134
MBR153 MBR172 MBR191 LONGMBR210    MBR229 MBR248 MBR267 LONGMBR286    MBR305
MBR324 MBR343 LONGMBR362    MBR381 MBR400 MBR419 LONGMBR438    MBR457

      (C) Copyright 2022 Underground Service Alert of Southern California
                          All rights reserved
Format Sample - New Ticket (WITH EPR LINK)


MBR001 00010A USAS 01/01/19 13:23:14 A121231234-01A NEW NORM POLY LREQ

Ticket: A121231234 Rev: 00A Created: 01/01/19 13:22 User: JSCHWILK  Chan: WEB
Work Start: 01/03/19 17:01 Legal Start: 01/03/19 17:01 Expires: 01/29/19 23:59
Response Required: Y Priority: 2

Excavator Information
Company: ABC COMPANY Type: CONT
Co Addr: 123 MAIN ST
City   : SOMEWHERE State: CA Zip: 12345-1234 
Created By: JIM SCHWILK Language: ENGLISH
Office Phone: 123-123-1234 x12345 SMS/Cell: 123-123-1234
Office Email: JIM@DOMAIN.COM

Site Contact: JAMES WINGATE
Site Phone: 123-123-1234 x12345 Site SMS/Cell: 123-123-1234
Site Email: JAMES@DOMAIN.COM

Excavation Area
State: CA County: LOS ANGELES Place: CARSON 
Zip: 90001,90002
Address: 12345 Street: MAIN ST
Cross 1: 1ST ST
Cross 2:
Location: SOME TEXT OF WHERE AT ADDRESS THE WORK IS
        : DOG IN YARD
Searchable Tags: #pipe_burst #microtrench #night_weekend
Job Size: sq-feet: 5700 sq-miles: 0.000204

Delineated Method: WHITE PAINT
Work Type: REPAIR AND REPLACE SOMETHING
Work For: JOES RESTAURANT
Permit: 123456789ABC Job/Work Order: AB123456
Project ID:  
Project Name: 
1 Year: N Boring: N Street/Sidewalk: Y Vacuum: Y Explosives: Y Pavement Only: N

Lat/Long
Center Generated (NAD83): ##.######/-###.###### ##.######/-###.######
            		: ##.######/-###.###### ##.######/-###.######
Excavator Provided: ##.######/-###.###### ##.######/-###.###### ##.######/-###.######
            	  : ##.######/-###.###### ##.######/-###.###### ##.######/-###.######
	          : ##.######/-###.###### ##.######/-###.###### ##.######/-###.######
        	  : THIS FIELD DOES NOT HAVE A HAVE A PREDETERMINED MAXIMUM LENGTH.  
	          : PLEASE SET SQL TO TEXT. EACH LINE WILL HAVE A MAXIMUM OF 3
        	  : LAT/LONGS.

Map Link:
https://somelink.doamin.com/linkinformationhereandthiscouldbealongstring

Post a response to this ticket at:
https://somelink.doamin.com/linkinformationhereandthiscouldbealongstring

Members: 
MBR001 MBR020 MBR039 LONGMBR058    MBR077 MBR096 MBR115 LONGMBR134
MBR153 MBR172 MBR191 LONGMBR210    MBR229 MBR248 MBR267 LONGMBR286    MBR305
MBR324 MBR343 LONGMBR362    MBR381 MBR400 MBR419 LONGMBR438    MBR457

      (C) Copyright 2022 Underground Service Alert of Southern California
                          All rights reserved
New Ticket - (FUTURE USE Project ticket)
MBR001 00010A USAS 01/01/19 13:23:14 A121231234-01A NEW NORM POLY PRJT

Ticket: A121231234 Rev: 00A Created: 01/01/19 13:22 User: JSCHWILK  Chan: WEB
Work Start: 01/03/19 17:01 Legal Start: 01/03/19 17:01 Expires: 01/29/19 23:59
Response Required: Y Priority: 2

Excavator Information
Company: ABC COMPANY Type: CONT
Co Addr: 123 MAIN ST
City   : SOMEWHERE State: CA Zip: 12345-1234 
Created By: JIM SCHWILK Language: ENGLISH
Office Phone: 123-123-1234 x12345 SMS/Cell: 123-123-1234
Office Email: JIM@DOMAIN.COM

Site Contact: JAMES WINGATE
Site Phone: 123-123-1234 x12345 Site SMS/Cell: 123-123-1234
Site Email: JAMES@DOMAIN.COM

Excavation Area
State: CA County: LOS ANGELES Place: CARSON 
Zip: 90001,90002
Address: 12345 Street: MAIN ST
Cross 1: 1ST ST
Cross 2:
Location: SOME TEXT OF WHERE AT ADDRESS THE WORK IS
        : DOG IN YARD
Searchable Tags: #pipe_burst #microtrench 
Job Size: sq-feet: 5700 sq-miles: 0.000204

Delineated Method: WHITE PAINT
Work Type: REPAIR AND REPLACE SOMETHING
Work For: JOES RESTAURANT
Permit: 123456789ABC Job/Work Order: AB123456
Project ID: 20210101000001A 
Project Name: WESTMONT TRACK
1 Year: N Boring: N Street/Sidewalk: Y Vacuum: Y Explosives: Y Pavement Only: N

Lat/Long
Center Generated (NAD83): ##.######/-###.###### ##.######/-###.######
            		: ##.######/-###.###### ##.######/-###.######
Excavator Provided: ##.######/-###.###### ##.######/-###.###### ##.######/-###.######
            	  : ##.######/-###.###### ##.######/-###.###### ##.######/-###.######
	          : ##.######/-###.###### ##.######/-###.###### ##.######/-###.######
        	  : THIS FIELD DOES NOT HAVE A HAVE A PREDETERMINED MAXIMUM LENGTH.  
	          : PLEASE SET SQL TO TEXT. EACH LINE WILL HAVE A MAXIMUM OF 3
        	  : LAT/LONGS.

Map Link:
https://somelink.doamin.com/linkinformationhereandthiscouldbealongstring

Members: 
MBR001 MBR020 MBR039 LONGMBR058    MBR077 MBR096 MBR115 LONGMBR134
MBR153 MBR172 MBR191 LONGMBR210    MBR229 MBR248 MBR267 LONGMBR286    MBR305
MBR324 MBR343 LONGMBR362    MBR381 MBR400 MBR419 LONGMBR438    MBR457

     (C) Copyright 2022 Underground Service Alert of Southern California
                          All rights reserved


Format Sample - Request Re-Marks
MBR001 00010W USAS 01/14/19 13:23:14 A121231234-01A REMK NORM POLY LREQ

Ticket: A121231234 Rev: 01A Created: 01/14/19 13:22 User: JSCHWILK Chan: WEB
Work Start: 01/03/19 17:01 Legal Start: 01/16/19 17:01 Expires: 02/11/19 23:59
Response Required: Y Priority: 2
Re-Marks Required: PHONE, CABLE TV

Excavator Information
Company: ABC COMPANY
Co Addr: 123 MAIN ST
City   : SOMEWHERE State: CA Zip: 12345-1234 
Created By: JIM SCHWILK Language: ENGLISH
Office Phone: 123-123-1234 x12345 SMS/Cell: 123-123-1234
Office Email: JIM@DOMAIN.COM

Site Contact: JAMES WINGATE
Site Phone: 123-123-1234 x12345 Site SMS/Cell: 123-123-1234
Site Email: JAMES@DOMAIN.COM

Excavation Area
State: CA County: LOS ANGELES Place: CARSON 
Zip: 90001,90002
Location: Address/Street: 12345 MAIN ST 
        : X/ST1: 1ST ST
        :
        : DOG IN YARD 
Searchable Tags: #pipe_burst #microtrench 
Job Size: sq-feet: 5700 sq-miles: 0.000204 Delineated Method: WHITE PAINT

Work Type: REPAIR AND REPLACE SOMETHING
Work For: JOES RESTAURANT
Permit: 123456789ABC Job/Work Order: AB123456
1 Year: N Boring: N Street/Sidewalk: Y Vacuum: Y Explosives: Y

Lat/Long
Center Generated (NAD83): ##.######/-###.###### ##.######/-###.######
		        : ##.######/-###.###### ##.######/-###.######
Excavator Provided: ##.######/-###.###### ##.######/-###.###### ##.######/-###.######
	          : ##.######/-###.###### ##.######/-###.###### ##.######/-###.######
        	  : ##.######/-###.###### ##.######/-###.###### ##.######/-###.######
	          : THIS FIELD DOES NOT HAVE A HAVE A PREDETERMINED MAXIMUM LENGTH.  
        	  : PLEASE SET SQL to TEXT. EACH LINE WILL HAVE A MAXIMUM OF 3
	          : LAT/LONGS.

Map Link:
https://somelink.doamin.com/linkinformationhereandthiscouldbealongstring

Comments:    
**REQUEST RE-MARKS** FROM PHONE, CABLE TV - WORK CONTINUING - ADDITIONAL COMMENTS FROM 
REQUESTOR HERE PER REQUESTORS NAME--[JSCHWILK 01/14/19 13:22]
    
Members: 
MBR001 MBR020 MBR039 LONGMBR058    MBR077 MBR096 MBR115 LONGMBR134
MBR153 MBR172 MBR191 LONGMBR210    MBR229 MBR248 MBR267 LONGMBR286    MBR305
MBR324 MBR343 LONGMBR362    MBR381 MBR400 MBR419 LONGMBR438    MBR457

     (C) Copyright 2018 Underground Service Alert of Southern California
                          All rights reserved
New Ticket - Excavator Confirmation
EMLCFM 00001A USAS 01/01/19 13:23:45 A121231234-00A NEW NORM POLY LREQ

Thank you for contacting Underground Service Alert of Southern California.
This is an automatically generated confirmation of your DigAlert.

For your safety please excavate carefully around the marked utility lines.

For more information regarding DigAlert's web portals, mobile apps and text
messaging, please visit www.digalert.org or text Services to DIGALT (344258).

This email comes from an automated program that is NOT MONITORED.
DO NOT REPLY TO THIS EMAIL.

This is not a certified copy of the ticket.

Ticket: A121231234 Rev: 00A Created: 01/01/19 13:22 User: JSCHWILK  
Type: NEW Priority: NORM Category: LREQ Chan: WEB

Work Start: 01/03/19 17:01 Legal Start: 01/03/19 17:01 Expires: 01/29/19 23:59
Response Required: Y Priority: 2

Excavator Information
Company: ABC COMPANY Type: CONT
Co Addr: 123 MAIN ST
City   : SOMEWHERE State: CA Zip: 12345-1234 
Created By: JIM SCHWILK Language: ENGLISH
Office Phone: 123-123-1234 x12345 SMS/Cell: 123-123-1234
Office Email: JIM@DOMAIN.COM

Site Contact: JAMES WINGATE
Site Phone: 123-123-1234 x12345 Site SMS/Cell: 123-123-1234
Site Email: JAMES@DOMAIN.COM

Excavation Area
State: CA County: LOS ANGELES Place: CARSON 
Zip: 90001,90002
Address: 12345 Street: MAINE ST
Cross 1: 1ST ST
Cross 2: 
Location: DOG IN YARD
Searchable Tags: #pipe_burst #microtrench 
Job Size: sq-feet: 5700 sq-miles: 0.000204

Delineated Method: WHITE PAINT
Work Type: REPAIR AND REPLACE SOMETHING
Work For: JOES RESTAURANT
Permit: 123456789ABC Job/Work Order: AB123456
Project ID:  
Project Name: 
1 Year: N Boring: N Street/Sidewalk: Y Vacuum: Y Explosives: Y Pavement Only: N

Lat/Long
Center Generated (NAD83): ##.######/-###.###### ##.######/-###.######
          		: ##.######/-###.###### ##.######/-###.######
Excavator Provided: ##.######/-###.###### ##.######/-###.###### ##.######/-###.######
          	  : ##.######/-###.###### ##.######/-###.###### ##.######/-###.######
	          : ##.######/-###.###### ##.######/-###.###### ##.######/-###.######
	          : THIS FIELD DOES NOT HAVE A HAVE A PREDETERMINED MAXIMUM LENGTH.  
	          : PLEASE SET SQL TO TEXT. EACH LINE WILL HAVE A MAXIMUM OF 3
	          : LAT/LONGS.

Map Link:
https://somelink.doamin.com/linkinformationhereandthiscouldbealongstring

Members:
MEMBERCODE1 MEMBER NAME               CONTANCT NAME            123-123-1234
MEMBERCODE2 MEMBER NAME               CONTANCT NAME            123-123-1234
MEMBERCODE3 MEMBER NAME               CONTANCT NAME            123-123-1234
MEMBERCODE4 MEMBER NAME               CONTANCT NAME            123-123-1234
MEMBERCODE5 MEMBER NAME               CONTANCT NAME            123-123-1234
MEMBERCODE6 MEMBER NAME               CONTANCT NAME            123-123-1234
MEMBERCODE7 MEMBER NAME               CONTANCT NAME            123-123-1234
MEMBERCODE8 MEMBER NAME               CONTANCT NAME            123-123-1234

     (C) Copyright 2022 Underground Service Alert of Southern California
                          All rights reserved

2023.1.1e_DigAlertFormatDocs.zip



  • No labels