{
  "name": "NCOALink return codes",
  "document": {
    "name": "NCOALink User Technical Reference Guide",
    "title": "NCOALink® User Technical Reference Guide",
    "edition": "2023-04-18",
    "url": "https://postalpro.usps.com/mnt/glusterfs/2023-04/usertechinfo_v12.pdf"
  },
  "home": "https://postalref.com/codes/ncoalink-return-codes",
  "columns": [
    "Code",
    "Return code",
    "New address provided",
    "Derived by data (D) or software (S)",
    "What it means",
    "Received during business matching logic",
    "Received during individual matching logic",
    "Received during family matching logic",
    "Retry matching attempts"
  ],
  "rows": [
    {"Code":"A","Return code":"COA Match","New address provided":"Y","Derived by data (D) or software (S)":"S","What it means":"The input record matched to a COA record. A new address could be furnished.* Please Note: If this return code is achieved, no other matching attempts are permitted regardless of the PROCESSING mode.","Received during business matching logic":"YES","Received during individual matching logic":"YES","Received during family matching logic":"YES","Retry matching attempts":"NO"},
    {"Code":"00","Return code":"NO Match","New address provided":"N","Derived by data (D) or software (S)":"S","What it means":"The input record COULD NOT BE matched to a COA record. A new address could not be furnished. This return code may be returned regardless of the processing mode, matching logic, or COA type. Please Note: When processing in any mode and this return code is received, it is required to attempt the match again using the next level of matching logic allowed by the processing mode.","Received during business matching logic":"YES","Received during individual matching logic":"YES","Received during family matching logic":"YES","Retry matching attempts":"attempt the match again using the next level of matching logic allowed by the processing mode"},
    {"Code":"01","Return code":"Found COA: Foreign Move","New address provided":"N","Derived by data (D) or software (S)":"D","What it means":"The input record matched to a COA record but the new address was outside the USPS delivery area. This return code may be returned regardless of the processing mode, matching logic, or COA type. Please Note: If this return code is achieved, no other matching attempts are permitted regardless of the PROCESSING mode.","Received during business matching logic":"YES","Received during individual matching logic":"YES","Received during family matching logic":"YES","Retry matching attempts":"NO"},
    {"Code":"02","Return code":"Found COA: Moved Left No Address(MLNA)","New address provided":"N","Derived by data (D) or software (S)":"D","What it means":"The input record matched to a COA record but the new address was not provided to the USPS. This return code may be returned regardless of the processing mode, matching logic, or COA type. Please Note: If this return code is achieved, no other matching attempts are permitted regardless of the PROCESSING mode.","Received during business matching logic":"YES","Received during individual matching logic":"YES","Received during family matching logic":"YES","Retry matching attempts":"NO"},
    {"Code":"03","Return code":"Found COA: Box Closed No Order(BCNO)","New address provided":"N","Derived by data (D) or software (S)":"D","What it means":"The Input record matched to a COA record containing an old address of PO BOX, which has been closed without a forwarding address provided. This return code may be returned regardless of the processing mode, matching logic, or COA type. Please Note: If this return code is achieved, no other matching attempts are permitted regardless of the PROCESSING mode.","Received during business matching logic":"YES","Received during individual matching logic":"YES","Received during family matching logic":"YES","Retry matching attempts":"NO"},
    {"Code":"04","Return code":"Cannot match COA: Street Address with Secondary","New address provided":"N","Derived by data (D) or software (S)":"D","What it means":"In the STANDARD mode utilizing Family matching logic the input record was a potential match to a family type COA record with an old address that contained secondary information. The input record does not contain secondary information. The record is a ZIP+4 street level match. This address match situation requires individual name matching logic to obtain a match and individual names do not match. Please Note: This return code is only obtained when processing in the STANDARD mode using Family matching logic.","Received during business matching logic":"NO","Received during individual matching logic":"NO","Received during family matching logic":"YES","Retry matching attempts":"NO"},
    {"Code":"05","Return code":"Found COA: New 11-digit DPBC is Ambiguous","New address provided":"N","Derived by data (D) or software (S)":"D","What it means":"The input record matched to a COA record. The new address on the COA record could not be converted to a deliverable address because the DPBC represents more than one delivery point. This return code may be returned regardless of the processing mode, matching logic, or COA type. Please Note: If this return code is achieved, no other matching attempts are permitted regardless of the PROCESSING mode.","Received during business matching logic":"YES","Received during individual matching logic":"YES","Received during family matching logic":"YES","Retry matching attempts":"NO"},
    {"Code":"06","Return code":"Cannot Match COA: Conflicting Directions: Middle Name Related","New address provided":"N","Derived by data (D) or software (S)":"D","What it means":"There is more than one COA record for the match algorithm and the middle names or initials on the COAs are different. Therefore, a single match result could not be determined. This return code is only obtained when using individual matching logic. Please Note: If this return code is achieved, no other matching attempts are permitted regardless of the PROCESSING mode.","Received during business matching logic":"NO","Received during individual matching logic":"YES","Received during family matching logic":"NO","Retry matching attempts":"NO"},
    {"Code":"07","Return code":"Cannot Match COA: Conflicting Directions: Gender Related","New address provided":"N","Derived by data (D) or software (S)":"D","What it means":"There is more than one COA record for the match algorithm and the genders of the names on the COAs are different. Therefore, a single match result could not be determined. This return code is only obtained when using individual matching logic. Please Note: If this return code is achieved, no other matching attempts are permitted regardless of the PROCESSING mode.","Received during business matching logic":"NO","Received during individual matching logic":"YES","Received during family matching logic":"NO","Retry matching attempts":"NO"},
    {"Code":"08","Return code":"Cannot Match COA: Other Conflicting Instructions","New address provided":"N","Derived by data (D) or software (S)":"D","What it means":"The input record was a potential match to two COA records. The two records were compared and due to differences in the new addresses, a match could not be made. This return code may be returned regardless of the processing mode, matching logic, or COA type. Please Note: If this return code is achieved, no other matching attempts are permitted regardless of the PROCESSING mode.","Received during business matching logic":"YES","Received during individual matching logic":"YES","Received during family matching logic":"YES","Retry matching attempts":"NO"},
    {"Code":"09","Return code":"Cannot Match COA: High-rise Default","New address provided":"N","Derived by data (D) or software (S)":"D","What it means":"The input record was a potential match to a family COA record from a High-rise address ZIP+4 coded to the building default. This address match situation requires individual name matching logic to obtain a match and individual names do not match. Please Note: This return code is only obtained when processing in the STANDARD mode using Family matching logic.","Received during business matching logic":"NO","Received during individual matching logic":"NO","Received during family matching logic":"YES","Retry matching attempts":"NO"},
    {"Code":"10","Return code":"Cannot Match COA: Rural Default","New address provided":"N","Derived by data (D) or software (S)":"D","What it means":"The input record was a potential match to a family COA record from a Rural Route or Highway Contract Route address ZIP+4 coded to the route default. This address situation requires individual name matching logic to obtain a match and individual names do not match. Please Note: This return code is only obtained when processing in the STANDARD mode using Family matching logic.","Received during business matching logic":"NO","Received during individual matching logic":"NO","Received during family matching logic":"YES","Retry matching attempts":"NO"},
    {"Code":"11","Return code":"Cannot Match COA: Individual Match: Insufficient COA Name for Match","New address provided":"N","Derived by data (D) or software (S)":"D","What it means":"There is a COA record with the same surname and address but there is insufficient first/middle name information on the COA record to produce a match using individual matching logic. This return code is only obtained when using individual matching logic. Please Note: When processing in the STANDARD mode and this return code is received utilizing Individual Logic, discontinue the Individual logic sequence and go straight to FAMILY matching logic.","Received during business matching logic":"NO","Received during individual matching logic":"YES","Received during family matching logic":"NO","Retry matching attempts":"When processing in the STANDARD mode and this return code is received utilizing Individual Logic it is required to attempt the match again using FAMILY matching logic."},
    {"Code":"12","Return code":"Cannot Match COA: Middle Name Test Failed","New address provided":"N","Derived by data (D) or software (S)":"S","What it means":"The input record was a potential match to a COA record. A match cannot be made because the input name contains a conflict with the middle name or initials on the COA record. This return code is only obtained when using individual matching logic. Please Note: If this return code is achieved, no other matching attempts are permitted regardless of the PROCESSING mode.","Received during business matching logic":"NO","Received during individual matching logic":"YES","Received during family matching logic":"NO","Retry matching attempts":"NO"},
    {"Code":"13","Return code":"Cannot Match COA: Gender Test Failed","New address provided":"N","Derived by data (D) or software (S)":"S","What it means":"The input record was a potential match to a COA record. A match cannot be made because the gender of the name on the input record conflicts with the gender of the name on the COA record. This return code is only obtained when using individual matching logic. Please Note: When processing in the STANDARD mode and this return code is received utilizing Individual Logic, discontinue the Individual logic sequence and go straight to FAMILY matching logic.","Received during business matching logic":"NO","Received during individual matching logic":"YES","Received during family matching logic":"NO","Retry matching attempts":"When processing in the STANDARD mode and this return code is received utilizing Individual Logic it is required to attempt the match again using FAMILY matching logic."},
    {"Code":"14","Return code":"Found COA: New Address Would Not Convert at Run Time","New address provided":"N","Derived by data (D) or software (S)":"S","What it means":"The input record matched to a COA record. The new address could not be converted to a deliverable address. This return code may be returned regardless of the processing mode, matching logic, or COA type. Please Note: If this return code is achieved, no other matching attempts are permitted regardless of the PROCESSING mode.","Received during business matching logic":"YES","Received during individual matching logic":"YES","Received during family matching logic":"YES","Retry matching attempts":"NO"},
    {"Code":"15","Return code":"Cannot Match COA: Individual Name Insufficient","New address provided":"N","Derived by data (D) or software (S)":"S","What it means":"The input record was a potential match to a COA record that contains a first initial and middle initial/name [ex. C M Smith or C Mary Smith]. A match cannot be made because the input middle initial/name is missing or does not equal the middle initial/name on the COA. This return code is only obtained when using individual matching logic. Please Note: When processing in the STANDARD mode and this return code is received utilizing Individual Logic, discontinue the Individual logic sequence and go straight to FAMILY matching logic.","Received during business matching logic":"NO","Received during individual matching logic":"YES","Received during family matching logic":"NO","Retry matching attempts":"When processing in the STANDARD mode and this return code is received utilizing Individual Logic it is required to attempt the match again using FAMILY matching logic."},
    {"Code":"16","Return code":"Cannot Match COA: Secondary Number Discrepancy","New address provided":"N","Derived by data (D) or software (S)":"S","What it means":"The input record was a potential match to a street level COA record. However, a match is prohibited because there is conflicting secondary information on the input and COA record. This return code is only obtained when using individual matching logic. Please Note: If this return code is achieved, no other matching attempts are permitted regardless of the PROCESSING mode.","Received during business matching logic":"NO","Received during individual matching logic":"YES","Received during family matching logic":"NO","Retry matching attempts":"NO"},
    {"Code":"17","Return code":"Cannot Match COA: Other Insufficient Name","New address provided":"N","Derived by data (D) or software (S)":"S","What it means":"The input record was a potential match to a COA record that contains a full first name and full middle name. The input middle initial/name is missing or different from the middle name on the COA. A match cannot be made because the first name on the COA was truncated (drop-n flag) and the middle names must be equal in order to make this match. This return code is only obtained when using individual matching logic. Please Note: When processing in the STANDARD mode and this return code is received utilizing Individual Logic, discontinue the Individual logic sequence and go straight to FAMILY matching logic.","Received during business matching logic":"NO","Received during individual matching logic":"YES","Received during family matching logic":"NO","Retry matching attempts":"When processing in the STANDARD mode and this return code is received utilizing Individual Logic it is required to attempt the match again using FAMILY matching logic."},
    {"Code":"18","Return code":"Cannot Match COA: General Delivery","New address provided":"N","Derived by data (D) or software (S)":"D","What it means":"The input record was a potential match to a COA record from a General Delivery address. This address situation requires individual name matching logic to obtain a match and individual names do not match. Please Note: This return code is only obtained when processing in the STANDARD mode using Family matching logic.","Received during business matching logic":"NO","Received during individual matching logic":"NO","Received during family matching logic":"YES","Retry matching attempts":"NO"},
    {"Code":"19","Return code":"Found COA: New Address not ZIP + 4 coded, New address primary number not DPV confirmable or Temporary Change Of Address**","New address provided":"N","Derived by data (D) or software (S)":"D","What it means":"There is a change of address on file but the new address cannot be ZIP + 4 coded and therefore there is no 11-digit DPBC to store or return, the new address primary number cannot be confirmed on DPV or the new address is temporary. This return code may be returned regardless of the processing mode, matching logic, or COA type. Please Note: If this return code is achieved, no other matching attempts are permitted regardless of the PROCESSING mode.","Received during business matching logic":"YES","Received during individual matching logic":"YES","Received during family matching logic":"YES","Retry matching attempts":"NO"},
    {"Code":"20","Return code":"Cannot Match COA: Conflicting Directions after re-chaining","New address provided":"N","Derived by data (D) or software (S)":"D","What it means":"Multiple COA records were potential matches to the input record. The COA records contained different new addresses and a single match result could not be determined. This return code may be returned regardless of the processing mode, matching logic, or COA type. Please Note: If this return code is achieved, no other matching attempts are permitted regardless of the PROCESSING mode.","Received during business matching logic":"YES","Received during individual matching logic":"YES","Received during family matching logic":"YES","Retry matching attempts":"NO"},
    {"Code":"66","Return code":"Daily Delete","New address provided":"N","Derived by data (D) or software (S)":"S","What it means":"The input record matched to a business, individual or family type COA record with an old address that is present in the daily delete file. The presence of an address in the daily delete file means that a COA record with this address is pending deletion from the COA master file and that no mail may be forwarded from this address. This return code may be returned regardless of the processing mode, matching logic or COA type. Please Note: If this return code is achieved, no other matching attempts are permitted regardless of the PROCESSING mode.","Received during business matching logic":"YES","Received during individual matching logic":"YES","Received during family matching logic":"YES","Retry matching attempts":"NO"},
    {"Code":"91","Return code":"COA Match: Secondary Number dropped from COA","New address provided":"Y","Derived by data (D) or software (S)":"S","What it means":"The input record matched to a COA record. The COA record had a secondary number and the input address did not. Please Note: This return code is derived from Individual and business matching logic only. If this return code is achieved, no other matching attempts are permitted regardless of the PROCESSING mode.","Received during business matching logic":"NO","Received during individual matching logic":"YES","Received during family matching logic":"NO","Retry matching attempts":"NO"},
    {"Code":"92","Return code":"COA Match: Secondary Number or Single Trailing Alpha Dropped from input address","New address provided":"Y","Derived by data (D) or software (S)":"S","What it means":"The input record matched to a COA record and either: a. The input address had a secondary number and the COA record did not. A second attempt is made by dropping the secondary number and trailing alpha or fractions from the original input address (is present). (OR) b. The record is a ZIP+4 street level match and the single trailing alpha was dropped to make a ZIP + 4 match (address matching returns a TA footnote). Please Note: This return code is derived from individual and business matching logic only. If this return code is achieved, no other matching attempts are permitted regardless of the PROCESSING mode.","Received during business matching logic":"NO","Received during individual matching logic":"YES","Received during family matching logic":"NO","Retry matching attempts":"NO"}
  ]
}
