Skip to content

Here is a complete, line-by-line breakdown of Figure 2-13 (CC TXMODA) from top to bottom, explaining what every field and code means so you can read and interpret these screens easily in the future.

  • Amount with - → generally a credit/reduction to the tax account.
  • Amount without - → generally a debit/increase to the tax account.

Full Example ​

--------------------------- Heading Section ---------------------------

TXMODA000-00-0216    MFT>30  TX-PRD>202212    PLN-NUM>    NM-CTRL>FINC
00000-000-92000-0<DLN                             BOD-CD>WI
                                                 MF-XTRCT-CYC>20232605 SC-REASON-CD>HH
                                        COMBAT ZONE
SC-STS>12    MOD-BAL>                 1565.00- CYC>202326
MF-STS>12    MOD-BAL>                 1565.00- CYC>20230805 TODAYS-DT>07/31/2023
                                                                   PRIMARY-LOC>7812
                                                  CL-LOC>12             PDC-IND>00


        COMBAT ZONE 
                                                           
ASED>04152026 FRZ> -R
CSED>04152033 INTL>
RSED>04152026 PSED>
                                                      EFT>5
CS-CTRL-INFO>NO CASE CONTROLS
-------------------------POSTED RETURN INFORMATION-------------------------
RET-RCVD-DT>04152023                                 TX/TPR>           2,184.00
FS>2         NUM-EXEMPT>02
AGI>            45,892.00                       EST-TX-BASE>           2,184.00
TXI>            26,492.00
                                       DDRR-CD>10
TX-SHOWN-RTN-AMT>             2,184.00   TAX-ASSESSED-AMT>           2,184.00





### Example 2
-------------------------POSTED RETURN INFORMATION-------------------------
                                                     TX/TPR>    3,173.00
RET-RCVD-DT>04152025
MTH-ERR>285
FS>4       NUM-EXEMPT>02
AGI>       55,119.00                         EST-TX-BASE>      3,173.00
TXI>       35,719.00    PRIM-SE-INCM>1,268.00         EST-CR-CLMD>     1,547.00
SET>          179.00    SECND-SE-INCM>       UNAPPLD-CR-ELECT>       345.00

PMEI>1,268.00                        SMEI>            DIR-DEP-REJ-RSN-CD>10
-------------------------RETURN TRANSACTION--------------------------------
     T/C  POSTED        TRANS-AMOUNT          CYC     T      DLN
     150  04152025          3,173.00     20251308     D 00221-076-06918-5
     806  04152025          7,929.00-    20251308       WTHLD TX CR POSTED W/RETURN






-------------------------RETURN TRANSACTION-------------------------
T/C    POSTED     TRANS-AMOUNT    CYC      T   DLN
150    03132023       2,184.00    20230805 D   00000-000-92000-0
806    04152023       3,749.00-   20230805     WTHLD TX CR POSTED W/RETURN

Header Line 1: Basic Module Identification ​

text
TXMODA000-00-0216    MFT>30    TX-PRD>202212    PLN-NUM>    NM-CTRL>FINC
  • TXMODA: Command Code used to request a specific tax module audit/history.

  • 000-00-0216: Formatted Taxpayer Identification Number (SSN/EIN).

  • MFT>30: Master File Tax Code 30 Individual Income Tax Return (Form 1040).

  • TX-PRD>202212: Tax Period ending December 2022 (Tax Year 2022).

  • PLN-NUM>: Plan Number (used for employee benefit plan returns; blank for Form 1040).

  • NM-CTRL>FINC: Name Control First 4 letters of the primary taxpayer's last name.


Header Line 2: Processing Status & Locations ​

text
00000-000-92000-0<DLN                             BOD-CD>WI
  • DLN: Document Locator Number A unique 14-digit tracking control number assigned to the tax return when received (by the Internal Revenue Service (IRS) to every tax return and document processed). It acts as a digital "barcode" or filing catalog number to help track, locate, and retrieve physical or electronic copies of specific tax records.

  • BOD-CD>WI: Operating Division Code W&I (Wage and Investment Division).

DLN Structure (14 Digits) ​

XX - X - XX - XXX - XXX - XX - X.

CodeDigitsWhat It MeansQuick Example
Location1–2IRS Processing Center09 = Ogden, 12 = Cincinnati
Tax Type3Type of tax filed/Tax Class/Type1 = Individual (1040) , 2= Fiduciary Income Tax (Form 1041),3 = Business/Corporate Tax (Form 1120/941),4 = Partnership Tax (Form 1065),6 = Estate/Gift Tax
Doc Class4–5Specific form number (Indicates the specific form or schedule being processed)10 = Form 1040, 05 = Form 941
Julian Date6–8Day of the year processed045 = Feb 14th
Block No.9–11Batch/Folder number123 = Batch 123
Serial No.12–13Form position in batch01 = 1st form
Year14Processing year6 = 2026

Example Breakdown ​

If your DLN is 09110045123016:

  1. 09: Processed at the Ogden IRS center.
  2. 1: Individual income tax (Form 1040).
  3. 10: Standard Form 1040 document class.
  4. 045: Processed on the 45th day of the year (February 14).
  5. 123: Processed in Batch/Block #123.
  6. 01: Item #1 inside that batch.
  7. 6: Processed in 2026.

4. Why Do You Need a DLN? ​

  • Tracking Refunds & Adjustments: Helps the IRS locate the exact paper file or electronic entry if there is a discrepancy.
  • Audit & Appeals Support: Used by tax professionals when requesting specific case files from the IRS.
  • State & Federal Verification: Certain government agencies request the DLN to verify that a tax return was officially received and logged by the IRS.

Header Line 3: Account Balances & Cycle Info ​

text
                                                 MF-XTRCT-CYC>20232605  SC-REASON-CD>HH
  • MF-XTRCT-CYC>20232605: Master File Extract Cycle Processed in Year 2023, Week 26, Day 05 (Thursday). Note that the "year" in this cycle refers to the processing year of the extract, not necessarily the tax year of the return itself.This is the internal computer batch code telling you when the IRS system pulled (extracted) this account data to update or process it.

  • SC-REASON-CD>HH: Special Condition / Reason Code System control flag used during posting. HH stands for "Hold / Freeze" or "Identity/Return Verification Hold."

    • It works directly with the line below it in the transcript (FRZ> -R), which stands for Refund Freeze.
    • It tells the system: "Do not automatically issue this $1,565 refund check yet because a specific hold condition (HH) was triggered during the week 26 extract."

Header Lines 4 & 5: Status, Balances & System Dates ​

text
SC-STS>12    MOD-BAL>                 1565.00- CYC>202326
MF-STS>12    MOD-BAL>                 1565.00- CYC>20230805  TODAYS-DT>07/31/2023
  • NOTE: The minus sign (-) in IRS accounting denotes a credit/overpayment balance (the taxpayer is due a refund of $1,565.00 unless held).

  • SC-STS>12 / MF-STS>12: Status Code 12 Indicates the module is in an active/posted processing status.

  • MOD-BAL> 1565.00-: Module Balance $1,565.00 Credit/Overpayment. The minus sign (-) in IRS systems indicates a credit balance in favor of the taxpayer.

  • CYC>202326 / 20230805: Posting cycles (Year 2023, Week 08, Day 05). This is the cycle when the last major activity or posting occurred on this module.

  • TODAYS-DT>07/31/2023: System date when this TXMODA screen was generated.

  • COMBAT ZONE: Indicates whether military combat zone rules apply (blank/no indicator following it means it is not active).


Header Right Indicators ​

text
                                                                   PRIMARY-LOC>7812
                                                  CL-LOC>12             PDC-IND>00
  • PRIMARY-LOC>7812: Primary Location Code. Identifies the IRS office, campus, or specific unit handling or assigned to the account.

  • CL-LOC>12: Current Location Code. The current IRS office or processing center actively working on the account. Sometimes may differ from the Primary Location.

  • PDC-IND>00: Private Debt Collection Indicator (00 = Not assigned to private collection).


Statute Dates & Freeze Section ​

text
ASED>04152026  FRZ> -R
CSED>04152033  INTL>
RSED>04152026  PSED>
                                                      EFT>5
  • ASED>04152026: Assessment Statute Expiration Date April 15, 2026 (IRS has 3 years from return due date to assess additional tax).

  • FRZ> -R: Freeze Code -R Hold placed on the $1,565.00 overpayment/refund.

  • CSED>04152033: Collection Statute Expiration Date April 15, 2033 (10 years to collect unpaid balances).

  • RSED>04152026: Refund Statute Expiration Date April 15, 2026 (Time limit for claiming a refund).(Under IRS rules, the deadline is generally 3 years from the date the return was filed OR 2 years from the date the tax was paid, whichever is later)

  • INTL> / PSED>: Interest Statute Expiration Date / Penalty Statute Expiration Date (blank if not applicable).

  • EFT>5: Electronic Funds Transfer indicator code.


Case Control & Special Condition Section ​

text
CS-CTRL-INFO>NO CASE CONTROLS
  • CS-CTRL-INFO>NO CASE CONTROLS: Indicates no active employee case control assignment on IDRS for this account.

Posted Return Information Block [Example - Temp] ​

###
-------------------------POSTED RETURN INFORMATION-------------------------
                                                     TX/TPR>    3,173.00
RET-RCVD-DT>04152025
MTH-ERR>285
FS>4       NUM-EXEMPT>02
AGI>       55,119.00                         EST-TX-BASE>      3,173.00
TXI>       35,719.00    PRIM-SE-INCM>1,268.00         EST-CR-CLMD>     1,547.00
SET>          179.00    SECND-SE-INCM>       UNAPPLD-CR-ELECT>       345.00

PMEI>1,268.00                        SMEI>            DIR-DEP-REJ-RSN-CD>10
-------------------------RETURN TRANSACTION--------------------------------
     T/C  POSTED        TRANS-AMOUNT          CYC     T      DLN
     150  04152025          3,173.00     20251308     D 00221-076-06918-5
     806  04152025          7,929.00-    20251308       WTHLD TX CR POSTED W/RETURN

Here is a field-by-field breakdown of the IDRS transcript output for your notes.

Posted Return Information Section ​

  • TX/TPR> 3,173.00 — Tax Per Return: The total tax liability computed or reported on the tax return.

  • RET-RCVD-DT>04152025 — Return Received Date: The date the IRS received the tax return (April 15, 2025).

  • MTH-ERR>285 — Math Error Code: IRS internal condition code indicating a specific math or processing error was detected/corrected on the return.

  • FS>4 — Filing Status: Code 4 corresponds to Head of Household.

  • NUM-EXEMPT>02 — Number of Exemptions: The number of exemptions claimed on the return (2).

  • AGI> 55,119.00 — Adjusted Gross Income: Total income after allowable deductions/adjustments ($55,119.00).

  • EST-TX-BASE> 3,173.00 — Estimated Tax Base: The base tax amount used to compute tax liability or estimated tax requirements ($3,173.00).

  • TXI> 35,719.00 — Taxable Income: Income subject to tax after standard/itemized deductions ($35,719.00).

  • PRIM-SE-INCM>1,268.00 — Primary Self-Employment Income: Net self-employment earnings for the primary taxpayer ($1,268.00).

  • EST-CR-CLMD> 1,547.00 — Estimated Credits Claimed: Total nonrefundable or estimated tax credits claimed ($1,547.00).

  • SET> 179.00 — Self-Employment Tax: Total self-employment tax calculated ($179.00).

  • SECND-SE-INCM> — Secondary Self-Employment Income: Self-employment income for the spouse (blank/zero).

  • UNAPPLD-CR-ELECT> 345.00 — Unapplied Credit Elect: Prior-year overpayment applied/elected to this year's tax liability ($345.00).

  • PMEI>1,268.00 — Primary Medical Expense / Self-Employment Indicator: Primary earned income / self-employment base amount ($1,268.00).

  • SMEI> — Secondary Medical Expense / Self-Employment Indicator: Secondary earned income indicator (blank).

  • DIR-DEP-REJ-RSN-CD>10 — Direct Deposit Rejection Reason Code: Code 10 indicates the direct deposit request was rejected by the system or bank, reverting the payout method.


Return Transaction Section Headers ​

  • T/C — Transaction Code: Three-digit IRS master file code identifying the specific accounting entry.

  • POSTED — Posted Date: Date the transaction posted to the master file.

  • TRANS-AMOUNT — Transaction Amount: Monetary value of the transaction.

  • CYC — Cycle Code: Format YYYYWWDD (20251308), representing the posting year, cycle week, and processing day.

  • T — Transaction / Freeze Indicator: Master file indicator flag (e.g., D).

  • DLN — Document Locator Number: Unique control number assigned to the filed return for tracking and retrieval.


Transaction Entries ​

  • 150 04152025 3,173.00 20251308 D 00221-076-06918-5

  • TC 150: Tax Return Filed & Initial Tax Assessment.

  • Posted Date: April 15, 2025.

  • Amount: $3,173.00 (Tax liability assessed).

  • Cycle: 20251308.

  • DLN: 00221-076-06918-5.

  • 806 04152025 7,929.00- 20251308 WTHLD TX CR POSTED W/RETURN

  • TC 806: Withholding Tax Credit.

  • Posted Date: April 15, 2025.

  • Amount: $7,929.00- (Credit/payment reducing balance, shown with a minus sign).

  • Cycle: 20251308.

  • Description: Tax withholding credit posted directly with the return.

Posted Return Information Block ​

text
-------------------------POSTED RETURN INFORMATION-------------------------
RET-RCVD-DT>04152023                                 TX/TPR>           2,184.00
FS>2         NUM-EXEMPT>02
AGI>            45,892.00                       EST-TX-BASE>           2,184.00
TXI>            26,492.00
                                       DDRR-CD>10
TX-SHOWN-RTN-AMT>             2,184.00   TAX-ASSESSED-AMT>           2,184.00
  • RET-RCVD-DT>04152023: Return Received Date April 15, 2023.

  • TX/TPR> 2,184.00: Total Tax per Return filed $2,184.00.

  • FS>2: Filing Status 2 Married Filing Jointly.

  • NUM-EXEMPT>02: 2 Personal Exemptions claimed.

  • AGI> 45,892.00: Adjusted Gross Income $45,892.00.

  • EST-TX-BASE> 2,184.00: Estimated Tax Base figure.

  • TXI> 26,492.00: Taxable Income $26,492.00.

  • DDRR-CD>10: Direct Deposit/Refund Restriction Code 10 Indicates an Injured Spouse Claim (Form 8379) filed with the return.

  • TX-SHOWN-RTN-AMT> 2,184.00: Tax liability reported on return $2,184.00.

  • TAX-ASSESSED-AMT> 2,184.00: Total tax amount formally assessed on Master File $2,184.00.


Return Transaction History Block ​

text
-------------------------RETURN TRANSACTION-------------------------
T/C    POSTED     TRANS-AMOUNT    CYC      T   DLN
150    03132023       2,184.00    20230805 D   00000-000-92000-0
806    04152023       3,749.00-   20230805     WTHLD TX CR POSTED W/RETURN
  • T/C: Transaction Code.

  • POSTED: Effective date the transaction posted to Master File.

  • TRANS-AMOUNT: Dollar amount associated with the transaction.

  • CYC: Cycle code when transaction posted.

  • DLN: Document Locator Number for that transaction.

Transaction Breakdown: ​

  1. TC 150 (Tax Return Processed):
  • Posted 03/13/2023 in Cycle 20230805.

  • Assessed Tax Liability: $2,184.00.

  1. TC 806 (Tax Withholding Credit):
  • Posted 04/15/2023 in Cycle 20230805.

  • Amount: $3,749.00- (Credit balance).

  • Description: WTHLD TX CR POSTED W/RETURN (Federal income tax withholding posted from Form W-2/1099).


Putting It All Together (How to Read the Story) ​

  1. The taxpayer filed a Married Filing Jointly (FS>2) Form 1040 for Tax Period 202212.

  2. Their reported Tax Liability was $2,184.00 (TC 150) and Withholding was $3,749.00 (TC 806).

  3. Subtracting Tax ($2,184.00) from Credit ($3,749.00) leaves an overpayment of $1,565.00 (MOD-BAL> 1565.00-).

  4. Because an Injured Spouse claim was filed (DDRR-CD>10), the system automatically placed an -R Freeze (FRZ> -R) to hold the $1,565.00 refund until the IRS computes the allocation between the primary taxpayer and spouse.

What to expect: ​

1. What the Taxpayer is Calling About ​

The taxpayer is usually calling because their tax refund is held or delayed (or they received an IRS notice/letter regarding their return).

They filed a joint return (Filing Status 2) expecting a refund of $1,565.00 (Withholding of $3,749.00 minus Tax Liability of $2,184.00), but they haven't received the money because an -R Freeze is active on the account.


2. What the IRS Employee Checks First (Account Diagnostics) ​

When you review the TXMODA screen on IDRS:

  1. FRZ> -R: Confirms a refund hold is active.

  2. DDRR-CD>10: Confirms an Injured Spouse Claim (Form 8379) was received with the return.

  3. FS>2: Confirms a Married Filing Jointly return.

  4. CS-CTRL-INFO>NO CASE CONTROLS: Shows no employee is currently working the case.


3. What the IRS Employee Explains to the Taxpayer ​

  • Explain the Hold: "Your refund is currently on hold because an Injured Spouse allocation (Form 8379) was filed with your joint tax return."

  • Explain the Reason: "When one spouse has a past-due debt (such as back taxes, student loans, or child support), Form 8379 protects the non-liable spouse's share of the overpayment so it isn't seized."

  • Provide Frame / Timeline: "The IRS must process the allocation formulas to determine how much of the $1,565.00 refund belongs to the injured spouse versus how much goes toward the debt."


4. How to Resolve / Solve the Issue ​

To resolve an -R freeze caused by an Injured Spouse claim, refer to IRM 21.5.6.4.35 and IRM 21.4.6.5.2:

  1. Verify Processing Timeframes:
  • Paper / Attached with Return: Normal processing time is 11 to 14 weeks from the date the return was received (04/15/2023 in this case).

  • If Filed Electronically: Processing time is typically 11 weeks.

  1. Check System Status:
  • If the time frame has not passed, advise the caller that the claim is processing and provide the expected date.

  • If the time frame has passed, check system logs to see if the allocation is pending in the Injured Spouse unit or needs to be referred to the specialized processing team via Form 4442/IDRS case control.

  1. Releasing the Freeze (System Action):
  • Once the allocation is computed by the processing unit, the non-liable spouse's portion is released via TC 290 / TC 846 (Refund release).

  • The -R freeze automatically clears once the adjustment/allocation transaction posts to the Master File.

irs-transcript
-------------------------POSTED TRANSACTIONS SECTION-------------------------
     T/C  POSTED      TRANS-AMOUNT  CYC-DAY  T       DLN
     766  04152025          400.00- 20251308    00221-076-06918-5  CR-ID-NUM>336
     766  04152025          354.00- 20251308    00221-076-06918-5  CR-ID-NUM>260
     660  02172025        1,000.00- 20250802    00221-053-06917-5
     768  04152025        2,050.00- 20251308    00209-055-06918-5
     846  04172025        8,359.00  20251308    00221-076-06918-5
                          RFND-PYMNT-DT>20250401                    DD>9
                      RSN>2025087181Z

     971  06122025            0.00  20251408    00228-124-75862-5  971-CD>138
                                                XREF-TIN>000-00-2929
-------------------------PENDING TRANSACTIONS SECTION------------------------
AP 0 291 00000000           300.00- 00000100    00254-206-05000-5
                 ADJ-RSN-CD>012-   -  AMD-CLMS-DT>05312025
                             ABST-NUM      ABST-AMT        ABST-NUM      ABST-AMT
                               886         2,015.00-         888         2,015.00-
AP 0 971 00000000             0.00- 00000100    00277-221-00000-5  971-CD>120

Posted Transactions ​

  • RFND-PYMNT-DT 20250401 → Refund payment date information
  • DD>9 → Direct deposit
  • RSN 2025087181Z → Refund/transaction reference information
  • XREF-TIN → Cross-reference TIN. another taxpayer ID number referenced by the IRS record. [To determine whose TIN it is and why it is being referenced, we would need to interpret the TC 971 + Action Code 138 and the surrounding IRS records. The XREF-TIN line alone isn't enough to conclude that another person's return is involved.]
  • TC 766 — $400 — CRN 336 → Refundable tax credit / ACTC
  • TC 766 — $354 — CRN 260 → Refundable tax credit / AOTC
  • TC 660 — $1,000 → Estimated tax payment
  • TC 768 — $2,050 → Earned Income Credit (EITC)
  • TC 846 — $8,359 → Refund issued
  • TC 971 — AC 138 → IRS informational/action entry

Pending Transactions ​

  • TC 291 — $300 → Tax abatement/adjustment
  • ADJ-RSN-CD 012 → Adjustment reason code
  • AMD-CLMS-DT 05312025 → Amended-claim date: May 31, 2025
  • ABST 886 — $2,015 → Adjustment/abatement reference amount
  • ABST 888 — $2,015 → Adjustment/abatement reference amount
  • TC 971 — AC 120 → Pending IRS informational/action entry

⭐ Most important ​

$1,000 estimated payment

  • $400 ACTC
  • $354 AOTC
  • $2,050 EITC → TC 846: $8,359 refund issued → DD: Direct deposit

Pending: $300 adjustment + two $2,015 abatement/reference amounts + TC 971 action 120.

DateCodeAmountSimple meaning
Feb 17660$1,000Estimated tax payment
Apr 15766 / CRN 336$400Additional Child Tax Credit
Apr 15766 / CRN 260$354American Opportunity Tax Credit
Apr 15768$2,050Earned Income Credit
Apr 17846$8,359Refund issued
Jun 12971 / AC 138$0IRS informational/action entry
Pending291$300Pending tax adjustment/abatement
Pending971 / AC 120$0Pending IRS informational/action entry
1040X LineTransaction CodeCRNDescriptionMaximum Limit / Cap & Statutory Rules
11150Tax liability assessed from original returnNo maximum limit. Equal to total calculated tax liability on original return.[cite: 1]
170Estimated tax penalty (manual computation)Variable / No fixed cap. Statutory percentage penalty based on federal short-term interest rates applied to underpaid amount.[cite: 1]
176Estimated tax penalty (insufficient payments)Variable / No fixed cap. Calculated based on underpayment per period.[cite: 1]
11290Additional tax assessmentNo maximum limit. Reflects additional tax determined upon audit/amendment.[cite: 1]
291Abate (reduce) prior tax assessmentLimited to previously assessed tax amount. Cannot exceed prior total assessments.[cite: 1]
13430Estimated tax payment (can establish tax module)No limit. Total estimated payments submitted by/for the taxpayer.[cite: 1]
570Balance due amount and/or Refund freezeSystem code (no limit). Hold applied to entire credit/refund balance.[cite: 1]
610Payment with returnNo limit. Actual remitted amount submitted with tax return.[cite: 1]
13660Estimated tax paymentNo limit. Total quarterly/annual estimated payments remitted.[cite: 1]
670Subsequent payment or prepaymentNo limit. Total remitted subsequent payments.[cite: 1]
13710Overpayment applied as estimated tax payment (manual)Limited to available credit balance from preceding tax period.[cite: 1]
716Overpayment credit applied from prior tax periodLimited to prior period overpayment chosen for election.[cite: 1]
12766252Credit for excess Social Security withheldAnnual limit per individual: Equal to excess withheld above maximum cap ($11,439 for tax year 2026, based on 6.2% rate up to wage base limit of $184,500).[cite: 1] Applies primarily when working for 2+ employers.
15766Refundable credit (see associated CRN)Variable by CRN. Maximum depends on specific credit line item below.[cite: 1]
15260American Opportunity Credit (refundable portion)• Annual Max Refundable: Up to $1,000 per eligible student/year (40% of max $2,500 total AOC).[cite: 1]
• Lifetime Max: 4 tax years per eligible student.
15336Additional Child Tax CreditAnnual Max: Up to $1,700 per qualifying child (up to 15% of earned income above $2,500).[cite: 1]
767Reversal of refundable credit (see associated CRN)Limited to previously allowed credit amount being reversed.[cite: 1]
14768764Earned Income Credit (EIC)Annual Max (2026):
• 0 Children: $664
• 1 Child: $4,427
• 2 Children: $7,316
• 3+ Children: $8,231
12806806Credit for federal income tax withheldNo statutory ceiling. Equal to actual federal income tax withheld (Form W-2 / 1099).[cite: 1]
807807Withholding reductionLimited to total withholding credited to taxpayer module.[cite: 1]
826Overpayment transferredLimited to net available overpayment transferred to another module/debt.[cite: 1]
836Overpayment Credit Elect transferredLimited to available overpayment transferred to next year's estimated tax.[cite: 1]
846Overpayment refundNo statutory cap. Equal to final calculated net refund balance.[cite: 1]

Personal IRS Customer Support Knowledge Base