201 Residential Loan Application (003050)

This is the standard X12 003050 spec, with 15 loops and 87 segment positions, as OpenEDI JSON, an ediFabric C# template and an ediFabric Native model. To change it for a trading partner, customize it in the EDI Spec Builder.

Loading the spec…

The spec as an OpenAPI 3 schema with x-openedi-* extensions, for ediFabric Native, ediFabric Cloud and the EDI Spec Builder. Download OpenEDI (82 KB) Generate classes

The ediFabric .NET template, class TS201. It needs the common segments, composites and codes of X12 003050, one download for every transaction in the version. Download C# (2 KB) Common files (204 KB)

The intermediary model ediFabric Native loads with set_map. Download Native (66 KB)

Use the 201 spec in your code

ediFabric .NET

Add the C# template and its common files to your project, or reference the template NuGet package, and read 201 files into TS201 objects. See ediFabric .NET.

ediFabric Native

Map version 003050 to the Native model with set_map, then parse 201 files to JSON from Python, Java, C or C#. See Convert between EDI and JSON.

OpenEDI

Select Customize in Spec Builder to copy the spec under your own name, change it for your partner, and parse files against it in EdiNation, ediFabric Native or ediFabric Cloud. Read about OpenEDI.

Generate 201 classes in Python, Java, Node.js, Go, Rust or C

ediFabric Native returns each 201 as JSON, with the property names of the OpenEDI schema. To work with that JSON as typed objects, generate classes from the OpenEDI file in your language and deserialize the JSON into TS201. Serialize the objects back to JSON to build EDI with ediFabric Native. The classes keep the loops, segments, lengths and code lists, but not the EDI data formats, so validate files with ediFabric Native. Read more in Generate a class from OpenEDI.

Python: datamodel-code-generator. Node.js: openapi-typescript. Java, Go, Rust and C: OpenAPI Generator.

201 structure

Loops and segments of the standard 201, with their usage and maximum repeats.

ID	Name	Usage	Max use
ST	Transaction Set Header	Optional	1
BGN	Beginning Segment	Mandatory	1
Loop N1	Name	Mandatory	5
N1	Name	Mandatory	1
N2	Additional Name Information	Optional	2
N3	Address Information	Optional	2
N4	Geographic Location	Optional	1
REF	Reference Numbers	Optional	1
PER	Administrative Communications Contact	Optional	5
Loop LRQ	Mortgage Characteristics Requested	Mandatory	>1
LRQ	Mortgage Characteristics Requested	Mandatory	1
REF	Reference Numbers	Mandatory	3
YNQ	Yes/No Question	Mandatory	4
N1	Name	Mandatory	1
N2	Additional Name Information	Optional	2
III	Information	Optional	2
DTP	Date or Time or Period	Optional	1
RLD	Down Payment Data	Optional	15
MCD	Mortgage Closing Data	Optional	1
Loop NX1	Property or Entity Identification	Mandatory	10
NX1	Property or Entity Identification	Mandatory	1
NX2	Real Estate Property ID Component	Mandatory	30
REA	Real Estate Property Information	Optional	1
PDS	Property Description/Legal Description	Optional	10
PDE	Property Metes and Bounds Description	Optional	50
Loop PEX	Property or Housing Expense	Mandatory	20
PEX	Property or Housing Expense	Mandatory	1
MSG	Message Text	Optional	1
Loop AMT	Monetary Amount	Optional	20
AMT	Monetary Amount	Mandatory	1
MSG	Message Text	Optional	1
Loop IN1	Individual Identification	Mandatory	15
IN1	Individual Identification	Mandatory	1
IN2	Individual Name Structure Components	Mandatory	10
YNQ	Yes/No Question	Mandatory	19
DTP	Date or Time or Period	Mandatory	3
REF	Reference Numbers	Optional	1
AMT	Monetary Amount	Optional	>1
DMG	Demographic Information	Optional	1
N10	Quantity and Description	Optional	1
MSG	Message Text	Optional	1
PER	Administrative Communications Contact	Optional	1
QTY	Quantity	Optional	>1
FTH	First Time Home Buyer	Optional	1
AIN	Income	Optional	10
PPY	Personal Property Description	Optional	20
Loop PEX	Property or Housing Expense	Optional	20
PEX	Property or Housing Expense	Mandatory	1
MSG	Message Text	Optional	1
Loop NX1	Property or Entity Identification	Optional	10
NX1	Property or Entity Identification	Mandatory	1
NX2	Real Estate Property ID Component	Mandatory	30
N10	Quantity and Description	Optional	1
ARS	Applicant Residence Specifics	Optional	1
Loop N1	Name	Optional	20
N1	Name	Mandatory	1
N2	Additional Name Information	Optional	2
N3	Address Information	Optional	2
N4	Geographic Location	Optional	1
PER	Administrative Communications Contact	Optional	1
ACT	Account Identification	Optional	10
YNQ	Yes/No Question	Optional	1
EMS	Employment Position	Optional	1
QTY	Quantity	Optional	2
DTP	Date or Time or Period	Optional	1
AMT	Monetary Amount	Optional	1
Loop REA	Real Estate Property Information	Optional	20
REA	Real Estate Property Information	Mandatory	1
AMT	Monetary Amount	Mandatory	6
NX1	Property or Entity Identification	Mandatory	1
NX2	Real Estate Property ID Component	Mandatory	30
Loop CDA	Consumer Credit Account	Optional	100
CDA	Consumer Credit Account	Mandatory	1
YNQ	Yes/No Question	Mandatory	1
N1	Name	Mandatory	1
N2	Additional Name Information	Optional	2
N3	Address Information	Optional	2
N4	Geographic Location	Optional	1
PER	Administrative Communications Contact	Optional	1
Loop FAA	Financial Asset Account	Optional	100
FAA	Financial Asset Account	Mandatory	1
N1	Name	Mandatory	1
N2	Additional Name Information	Optional	2
N3	Address Information	Optional	2
N4	Geographic Location	Optional	1
PER	Administrative Communications Contact	Optional	1
MSG	Message Text	Optional	1
Loop LS	Loop Header	Optional	1
LS	Loop Header	Mandatory	1
Loop AMT	Monetary Amount	Optional	10
AMT	Monetary Amount	Mandatory	1
MSG	Message Text	Optional	1
LE	Loop Trailer	Mandatory	1
Loop LX	Assigned Number	Mandatory	5
LX	Assigned Number	Mandatory	1
N1	Name	Optional	1
N2	Additional Name Information	Optional	2
N3	Address Information	Optional	2
N4	Geographic Location	Optional	1
PER	Administrative Communications Contact	Optional	1
DTP	Date or Time or Period	Optional	1
SE	Transaction Set Trailer	Optional	1