Excavators & DIYers
Breadcrumbs

Response Codes


Released: 10/29/24

Effective: 1/1/25


Electronic Positive Response (EPR) Codes as defined by DigAlert®

The EPR codes on this page are maintained by DigAlert®.  These codes are used for members to submit responses to DigAlert's® EPR servers.

For Excavators wishing to check responses, please see → Verifying Responses via Website .  The responses will be displayed with the description, not the code.

More information!

For more information on what the response codes mean and when to use them, please see Best Practices .

Response Code

Description

000

Reserved for system use only



001

Clear - No conflict

003

Existing markings adequate

004

No markings requested



010

Locate area marked

014

Partially marked - More time is needed

015

Provided facility location information to excavator (4216.3(a)(1)(A)(ii))

016

Operator has located and marked all subsurface installations known to be embedded in the pavement 4216.3(b)



020

Bad address/incorrect street/location info - New ticket required

021

No access to locate area - Resend ticket requested

022

No delineation - Resend ticket requested



031

Requires stand by at time of excavation - Contact facility owner

033

High priority line in area - On site meeting required

034

Field meet required - Contact facility owner to schedule



040

Excavator completed work prior to due date

041

Excavator no show for meet

042

Excavator canceled request (system use only)



050

Negotiated marking schedule

051

Mutually agreed to a later start date and time (4216.3(a)(1)(A))

053

Scheduled meet with excavator at requested date and time



080

Extraordinary circumstances exist - No locate due to weather/emergency/safety conditions



998

DigAlert® Test Code - No Lines In Area

999

Member did not respond by required time (system use only)

To integrate these response codes with your ticket management system, you can retrieve this list via API by accessing https://das.digalert.org/v1/getresponse-codes as a GET. This API will return the following JSON formatted message.

Field definitions:

“last_change” displays the date the last change was made to the EPR codes as a string

“version” displays the EPR Codes JSON file version as a string

“response_codes”:

“response” displays the EPR response code (three numbers as a string)

“state” displays the state/center as a string (max 4 chars) - For Underground Service Alert of Southern California will always show CA-S

“description” displays the readable description of the EPR response code as a string

“allowed” displays wether the EPR code is available for public use as a bit/boolean. “false” means this code can only be used by DigAlert’s® system internally. “true” means the EPR code can be used by members when posting.

{{
  "last_change": "2024-11-12",
  "version": "24.11.12.1",
  "response_codes": [
    {
      "response": "000",
      "state": "CA-S",
      "description": "Member has not responded yet",
      "allowed": false
    },
    {
      "response": "001",
      "state": "CA-S",
      "description": "CLEAR - NO CONFLICT",
      "allowed": true
    },
    {
      "response": "003",
      "state": "CA-S",
      "description": "EXISTING MARKINGS ADEQUATE",
      "allowed": true
    },
    {
      "response": "004",
      "state": "CA-S",
      "description": "NO MARKINGS REQUESTED",
      "allowed": true
    },
    {
      "response": "010",
      "state": "CA-S",
      "description": "LOCATE AREA MARKED",
      "allowed": true
    },
    {
      "response": "014",
      "state": "CA-S",
      "description": "PARTIALLY MARKED - MORE TIME IS NEEDED",
      "allowed": true
    },
    {
      "response": "015",
      "state": "CA-S",
      "description": "PROVIDED FACILITY LOCATION INFORMATION TO EXCAVATOR (4216.3(A)(1)(A)(II))",
      "allowed": true
    },
    {
      "response": "016",
      "state": "CA-S",
      "description": "OPERATOR HAS LOCATED AND MARKED ALL SUBSURFACE INSTALLATIONS KNOWN TO BE EMBEDDED IN THE PAVEMENT (4216.3 (e))",
      "allowed": true
    },
    {
      "response": "020",
      "state": "CA-S",
      "description": "BAD ADDRESS/INCORRECT STREET/LOCATION INFO - NEW TICKET REQUIRED",
      "allowed": true
    },
    {
      "response": "021",
      "state": "CA-S",
      "description": "NO ACCESS TO LOCATE AREA - RESEND TICKET REQUIRED",
      "allowed": true
    },
    {
      "response": "022",
      "state": "CA-S",
      "description": "NO DELINEATION - RESEND TICKET REQUESTED",
      "allowed": true
    },
    {
      "response": "031",
      "state": "CA-S",
      "description": "REQUIRES STAND BY AT TIME OF EXCAVATION - CONTACT FACILITY OWNER",
      "allowed": true
    },
    {
      "response": "033",
      "state": "CA-S",
      "description": "HIGH PRIORITY LINE IN AREA - ON SITE MEETING REQUIRED",
      "allowed": true
    },
    {
      "response": "034",
      "state": "CA-S",
      "description": "FIELD MEET REQUIRED - CONTACT FACILITY OWNER TO SCHEDULE",
      "allowed": true
    },
    {
      "response": "040",
      "state": "CA-S",
      "description": "EXCAVATOR COMPLETED WORK PRIOR TO DUE DATE",
      "allowed": true
    },
    {
      "response": "041",
      "state": "CA-S",
      "description": "EXCAVATOR NO SHOW FOR MEET",
      "allowed": true
    },
    {
      "response": "042",
      "state": "CA-S",
      "description": "EXCAVATOR CANCELED REQUEST",
      "allowed": false
    },
    {
      "response": "050",
      "state": "CA-S",
      "description": "NEGOTIATED MARKING SCHEDULE",
      "allowed": true
    },
    {
      "response": "051",
      "state": "CA-S",
      "description": "MUTUALLY AGREED TO A LATER START DATE AND TIME (4216.3(A)(1)(A))",
      "allowed": true
    },
    {
      "response": "053",
      "state": "CA-S",
      "description": "SCHEDULED MEET WITH EXCAVATOR AT REQUESTED DATE AND TIME",
      "allowed": true
    },
    {
      "response": "080",
      "state": "CA-S",
      "description": "EXTRAORDINARY CIRCUMSTANCES EXIST - NO LOCATE DUE TO WEATHER/EMERGENCY/SAFETY CONDITIONS",
      "allowed": true
    },
    {
      "response": "998",
      "state": "CA-S",
      "description": "DIGALERT TEST CODE - NO LINES IN AREA",
      "allowed": false
    },
    {
      "response": "999",
      "state": "CA-S",
      "description": "Member did not respond by the required time",
      "allowed": false
    }
  ]
}