E-File Magic

Documents & delivery

Download TIN Matching results

Get one order’s results as CSV, JSON, or XML. Each format contains the same results.

Illustration of a comparison report with two aligned blank identity columns beside a blue download tray.
In this guide

Results not available yet?

Check the order’s TIN Matching service in Order Tracking. Files are prepared automatically after the whole order finishes processing.

Read the Order Tracking guide

Before you start

The right account

Sign in to the account that owns the order.

Completed processing

Files are prepared after the whole order finishes.

Your preferred format

Choose the format your spreadsheet or integration expects.

View all setup requirements
  • Sign in to the account that owns the order.
  • Wait for TIN matching results to be posted. Files are prepared automatically after the whole order has finished processing.

Download and review your results

  1. Find your order

    Open Orders → TIN Matching Result Files and find your order.

  2. Wait for file preparation

    Select the order and wait until file preparation finishes.

  3. Choose a download format

    Click Download CSV, Download JSON, or Download XML.

    CSV
    Use with a spreadsheet; import Tax ID as text.
    JSON or XML
    Choose the format your integration expects.

    All three formats contain the same results.

  4. Preserve leading zeros

    When importing CSV into a spreadsheet, treat the Tax ID column as text to preserve leading zeros.

  5. Review each recipient’s outcome

    Review each recipient’s result and description. A file may include nonmatches, canceled requests, or requests needing attention.

Your browser downloads the selected format using a short-lived link for this order.

Page details and controls
Choose an order

Search, Sort By, Status, Rows, Previous, and Next apply to the order directory. The Deliverable Type field stays locked to TIN Matching Result Files. Loading, no-results, and error messages explain the current state; use the error close button to dismiss a message.

Download results

The right panel shows the selected order and three format choices. Download buttons stay disabled during preparation or another download request. Preparation updates automatically. If no order is selected, select one from the directory.

Actions and controls
  • Open Orders → TIN Matching Result Files. Deliverable Type is selected automatically and cannot be changed on this screen.
  • Search by order reference, filer, or filing year. Use Status and Sort By to narrow and order the directory. Relevance is available while searching.
  • Change Rows and use Previous or Next to page through orders, then select an Order + Deliverable row.
  • Review the selected order reference, filer, tax year, recipient count, and last update time.
  • Choose Download CSV, Download JSON, or Download XML when the files are ready. All three contain the same results.
  • Open the Order Deliverables links from Order Tracking after the TIN matching service completes.
  • Use Refresh files to check the latest availability. The compact format rows show whether each download is ready.

If you get stuck

The order is not listed.

Confirm you are in the correct account and that results have been posted. For a previously completed order, open its Order Deliverables link from Order Tracking.

Files are still being prepared.

Leave the order selected while the screen checks for completion automatically. Large orders may take longer.

A download failed or the link expired.

Click the download button again to request a fresh link. If file preparation failed, contact support with the order reference.

More troubleshooting (1)
The list is empty. Does that mean every recipient matched?

No. Clear the search, set Status to All statuses and check the account and order. Download the ready result file and review each result; file availability does not mean every name and Tax ID matched.