# NCOALink return codes

All 25 NCOALink return codes in the NCOALink User Technical Reference Guide of April 18, 2023, each with what it means.[^1]

Updated April 18, 2023. 2 sources. Every row as [CSV](https://postalref.com/codes/ncoalink-return-codes.csv) or [JSON](https://postalref.com/codes/ncoalink-return-codes.json).

## What it is

USPS defines an NCOALink return code this way: “When a match or a near match of a name and address to NCOALink is identified, an NCOALink return code is provided indicating the type of match made or reason that a match could not be made.”[^2]

Each row gives a code, then these columns:[^1]

- return code
- new address provided
- Derived by data (D) or software (S)

A row opens to these:

- what it means
- received during business matching logic
- received during individual matching logic
- received during family matching logic
- retry matching attempts

## Every code

| Code | Return code | New address provided | Derived by data (D) or software (S) |
| --- | --- | --- | --- |
| `A` | COA Match | Y | S |
| `00` | NO Match | N | S |
| `01` | Found COA: Foreign Move | N | D |
| `02` | Found COA: Moved Left No Address(MLNA) | N | D |
| `03` | Found COA: Box Closed No Order(BCNO) | N | D |
| `04` | Cannot match COA: Street Address with Secondary | N | D |
| `05` | Found COA: New 11-digit DPBC is Ambiguous | N | D |
| `06` | Cannot Match COA: Conflicting Directions: Middle Name Related | N | D |
| `07` | Cannot Match COA: Conflicting Directions: Gender Related | N | D |
| `08` | Cannot Match COA: Other Conflicting Instructions | N | D |
| `09` | Cannot Match COA: High-rise Default | N | D |
| `10` | Cannot Match COA: Rural Default | N | D |
| `11` | Cannot Match COA: Individual Match: Insufficient COA Name for Match | N | D |
| `12` | Cannot Match COA: Middle Name Test Failed | N | S |
| `13` | Cannot Match COA: Gender Test Failed | N | S |
| `14` | Found COA: New Address Would Not Convert at Run Time | N | S |
| `15` | Cannot Match COA: Individual Name Insufficient | N | S |
| `16` | Cannot Match COA: Secondary Number Discrepancy | N | S |
| `17` | Cannot Match COA: Other Insufficient Name | N | S |
| `18` | Cannot Match COA: General Delivery | N | D |
| `19` | Found COA: New Address not ZIP + 4 coded, New address primary number not DPV confirmable or Temporary Change Of Address** | N | D |
| `20` | Cannot Match COA: Conflicting Directions after re-chaining | N | D |
| `66` | Daily Delete | N | S |
| `91` | COA Match: Secondary Number dropped from COA | Y | S |
| `92` | COA Match: Secondary Number or Single Trailing Alpha Dropped from input address | Y | S |

25 codes in the NCOALink Return Code Descriptions, User Technical Reference.

## Sources

[^1]: [NCOALink® User Technical Reference Guide](https://postalpro.usps.com/mnt/glusterfs/2023-04/usertechinfo_v12.pdf). [page 12](https://postalpro.usps.com/mnt/glusterfs/2023-04/usertechinfo_v12.pdf#page=12): “COA Match”

[^2]: [Guide to Move Update](https://postalpro.usps.com/mnt/glusterfs/2024-01/Guide%20to%20Move%20Update.pdf). [page 23](https://postalpro.usps.com/mnt/glusterfs/2024-01/Guide%20to%20Move%20Update.pdf#page=26): “When a match or a near match of a name and address to NCOALink is identified, an NCOALink return code is provided indicating the type of match made or reason that a match could not be made.”

---

Unofficial. Not affiliated with or endorsed by the United States Postal Service. This is https://postalref.com/codes/ncoalink-return-codes as Markdown.
