Decode IRS e-file rejection codes (R0000-504, IND-031, IND-181, FW2-502, F8962-006…) instantly. Each entry shows what the code means, why it triggered, exact fix steps, and a tax-preparer note for the trickier ones. Built for the moment a software displays a cryptic reject and you need an answer fast.
🔎
Showing all reject codes
⚠️
Pick a reject code on the left
Or paste the reject code from your tax software. Common ones:
Rejects come from IRS Modernized e-File (MeF) when a return fails validation. The reject code has two parts — the schema family (R0000, IND, F1040, FW2, etc.) and the specific reject reason. Most rejects can be fixed by correcting the data and re-transmitting; the IRS treats the re-filed return as timely if the original was transmitted by the deadline AND it's accepted within 5 calendar days of the reject (per Pub 4163). If you cannot fix the reject before the 5-day grace period, paper-file the return and attach Form 8948 (Preparer Explanation for Not Filing Electronically). For identity-related rejects (R0000-500/503/504, IND-901), assume potential identity theft and file Form 14039 if confirmed.
How IRS e-file reject codes work
When the IRS Modernized e-File (MeF) system rejects a return, it returns a business-rule code (for example, IND-031-04 or R0000-507-01) that pinpoints exactly which validation failed. A reject is not an audit and not a penalty — the return simply was not accepted, so it is treated as not filed until you correct the error and retransmit. The code is the fastest way to identify and fix the problem.
Most rejects fall into a handful of buckets: identity and prior-year verification mismatches, duplicate use of a Social Security number, and dependent conflicts. This tool translates the common codes into plain language and the specific fix each one requires.
Common reject codes
IND-031-04 and IND-032-04 mean the prior-year AGI or self-select PIN used to sign the return does not match IRS records — the usual fix is to enter the exact AGI from last year’s originally filed return (or $0 if last year’s return was filed late or is still processing). R0000-507-01 means a dependent’s SSN was already claimed on another return; F1040-516 means the primary taxpayer’s SSN was claimed as a dependent elsewhere. R0000-902-01 indicates a return with that SSN was already accepted (a duplicate filing or possible identity theft). R0000-500-01 means the name and SSN do not match Social Security Administration records, often from a recent name change.
Common mistakes & edge cases
For AGI rejects, use the AGI from the original return, not an amended one, and remember that a return processed after mid-November of the prior year may require entering $0. If a dependent or SSN-conflict reject is caused by someone else having already claimed that person, and you are entitled to the claim, you generally must paper-file and let the IRS resolve the duplicate; attach Form 14039 if identity theft is suspected. The IRS allows a short “perfection period” (commonly five calendar days) to correct and retransmit a rejected return while keeping the original timely-filed date, so fix and resubmit promptly rather than waiting.
Frequently asked questions
Does an e-file rejection mean I am in trouble?
No. A rejection only means the return failed a validation check and was not accepted. It is not an audit or penalty. Correct the error indicated by the reject code and retransmit; the return is considered filed once accepted.
How do I fix an AGI mismatch reject?
Enter the adjusted gross income exactly as shown on your originally filed prior-year return. If that return was filed very late or is still being processed, try entering $0 for the prior-year AGI, which the IRS often expects in that situation.
What if someone already claimed my dependent?
If a return was rejected because the dependent’s SSN was already used and you are entitled to claim that person, you generally need to paper-file your return. The IRS will then contact both parties to resolve the duplicate claim; include Form 14039 if you suspect identity theft.