-
Notifications
You must be signed in to change notification settings - Fork 0
/
2020-09-21-Prescreen Of One.yaml
10958 lines (10344 loc) · 704 KB
/
2020-09-21-Prescreen Of One.yaml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
openapi: 3.0.0
info:
description: |
# Introduction
Equifax’s Prescreen of One is a sales tool that is intended to entice the consumer to take a step toward opening a credit or loan account. Lenders can make offers of credit or insurance, in real time, in person or over the phone.
# Getting Started
1. **<a href="/user/applications" target="_blank">Create</a>** an application
2. **<a href="/user/applications" target="_blank">Subscribe</a>** to Prescreen of One API
3. **<a href="/products/consumer-credit-report" target="_blank">Explore</a>** the Sandbox environment
# Promoting to UAT
To successfully submit test transactions through your application in the UAT environment, a test member number is required. You may use your existing Equifax test member number(s). Please contact your Equifax Account Representative if a new test member number is needed. The steps below can be used to test in the UAT environment.
Transactions generated using a test member number do not return identical results as a sandbox transaction. A sandbox transaction will reflect everything that is exposed in the API whereas a test member number is configured to align with the specifications of your contract. Please contact us to ensure your test member number is configured to your expectations.
1. **<a href="/user/applications" target="_blank">Promote</a>** application to test
2. **<a href="/documentation" target="_blank">Update</a>** requests details for UAT
3. **<a href="/documentation" target="_blank">Test</a>** scenarios in UAT environment
# For More Details
* **<a href="/contact" target="_blank">Contact Us</a>** - Equifax Developer Center Support Website
* **ACRO Migration Support**
* phone: 1-888-407-0359; Option 2 followed by Option 5
* email: [email protected]
version: 1.0.0
title: Prescreen of One
termsOfService: ''
servers:
- description: SANDBOX URL
url: 'https://api.sandbox.equifax.com/business/prescreen-of-one/v1/'
paths:
/report-requests:
post:
tags:
- Prescreen of One
operationId: requestPrescreenOfOne
security:
- OAuth 2.0: ["scopes: https://api.equifax.com/business/prescreen-of-one/v1"]
parameters:
- in: header
name: efx-client-correlation-id
description: ID provided by client to uniquely track service request
required: false
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreditReportRequest'
examples:
request:
$ref: '#/components/examples/CreditReportRequest'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/CreditReportResponse'
examples:
response:
$ref: '#/components/examples/CreditReportResponse'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/APIErrorResponse'
examples:
'400.01':
$ref: '#/components/examples/400.01'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/APIErrorResponse'
examples:
'401.03':
$ref: '#/components/examples/401.03'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/APIErrorResponse'
examples:
'403.01':
$ref: '#/components/examples/403.01'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/APIErrorResponse'
examples:
'404.01':
$ref: '#/components/examples/404.01'
'415':
description: Unsupported Media Type
content:
application/json:
schema:
$ref: '#/components/schemas/APIErrorResponse'
examples:
'415.01':
$ref: '#/components/examples/415.01'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/APIErrorResponse'
examples:
'500.01':
$ref: '#/components/examples/500.01'
'501':
description: Not-implemented
content:
application/json:
schema:
$ref: '#/components/schemas/APIErrorResponse'
examples:
'501.01':
$ref: '#/components/examples/501.01'
'503':
description: Service Unavailable
content:
application/json:
schema:
$ref: '#/components/schemas/APIErrorResponse'
examples:
'503.01':
$ref: '#/components/examples/503.01'
'504':
description: Gateway timeout
content:
application/json:
schema:
$ref: '#/components/schemas/APIErrorResponse'
examples:
'504.01':
$ref: '#/components/examples/504.01'
components:
securitySchemes:
OAuth 2.0:
type: http
scheme: bearer
schemas:
FullDate:
type: string
format: date
description: Date in format MMDDYYYY where MM is the Month, DD is the day of the month and YYYY is the year
minLength: 0
maxLength: 8
example: "MMDDYYYY"
PartialDate:
type: string
description: Date in format MMYYYY where MM is the Month and YYYY is the year
maxLength: 6
example: "MMYYYY"
TelephoneNumber:
type: string
maxLength: 10
description: Telephone number including a valid area code
CreditorClassificationCode:
type: object
minItems: 0
maxItems: 2
description: >
A general type of business for the original creditor and is only applicable for trades reported by Debt Buyers
properties:
code:
type: string
description: Code value
description:
type: string
description: >
Business type of original creditor
- 01: RETAIL
- 02: MEDICAL/HEALTH CARE
- 03: OIL COMPANY
- 04: GOVERNMENT
- 05: PERSONAL SERVICES
- 06: INSURANCE
- 07: EDUCATIONAL
- 08: BANKING
- 09: RENTAL/LEASING
- 10: UTILITIES
- 11: CABLE/CELLULAR
- 12: FINANCIAL
- 13: CREDIT UNION
- 14: AUTOMOTIVE
- 15: CHECK GUARANTEE
FraudVerificationWarningCodes:
type: array
minItems: 0
maxItems: 4
items:
type: object
properties:
code:
type: string
maxLength: 3
description: >
Warning codes and descriptions:
- 801: Important Application Data Missing
- 802: The input SSN is reported as deceased
- 803: The input SSN was issued prior to the input Date of Birth
- 804: The input Last Name and SSN are verified, but not with the input Address and Phone
- 805: The input bill-to and ship-to addresses are geographically distant
- 806: The input SSN is invalid
- 807: The input phone number may be disconnected
- 808: The input phone number is potentially invalid
- 809: The input phone number is a pager number
- 810: The input phone number is a mobile number
- 811: The input address may be invalid according to postal specifications
- 812: The input zip code belongs to a post office box
- 813: The input address has an invalid apartment designation
- 814: The input address is a transient commercial or institutional address
- 815: The input phone number matches a transient commercial or institutional address
- 816: The input phone number and input zip code combination is invalid
- 817: The input bill-to and ship-to phone numbers are geographically distant
- 818: Unused - Future Use
- 819: Unable to verify name, address, SSN/TIN and phone
- 820: Unable to verify applicant name, address and phone number
- 821: Unable to verify applicant name and phone number
- 822: Unable to verify applicant name and address
- 823: Unable to verify applicant name and SSN
- 824: Unable to verify applicant address and SSN
- 825: Unable to verify applicant address
- 826: Unable to verify SSN / TIN
- 827: Unable to verify applicant phone number
- 828: Unable to verify applicant date-of-birth
- 829: The input SSN/TIN may have been miskeyed
- 830: The input address may have been miskeyed
- 831: The input phone number may have been miskeyed
- 832: The input name matches the OFAC file
- 834: Incomplete verification
- 835: Insufficient verification to return a score under CA law
- 836: Identity elements not fully verified on all available sources
- 837: Unable to verify applicant name
- 838: The input SSN is associated with multiple last names
- 839: The input SSN is recently issued
- 840: The input zip code is a corporate-only, military zip code
- 841: The input driver’s license number is invalid for the input DL State
- 842: The input SSN matches the bankruptcy file
- 843: The input name and address match the bankruptcy file
- 844: The input phone area code is changing
- 845: The input SSN and address are not associated with the input last name and phone
- 847: The input phone is associated with a different business name or address
- 848: Unable to verify first name
- 849: The input phone and address are geographically distant (>10 miles)
- 850: The input address matches a prison address
- 851: The input last name is not associated with the input SSN
- 852: The input first name is not associated with input SSN
- 853: The input home phone and work phone are geographically distant (>100 miles)
- 855: The input work phone is potentially invalid
- 856: The input work phone is potentially disconnected
- 857: The input work phone is a mobile number
- 864: The input address returns a different phone number
- 866: The input SSN is associated with a different last name, same first name
- 871: The input SSN is not found in the public record
- 872: The input SSN is associated with a different name and address
- 873: The input phone number is not found in the public record
- 874: The input phone number is associated with a different name and address
- 875: The input name and address are associated with an unlisted/non-published phone number
- 876: The input name may have been miskeyed
- 877: The input name was missing
- 878: The input address was missing
- 879: The input SSN/TIN was missing or incomplete
- 880: The input phone was missing or incomplete
- 881: The input date-of-birth was missing or incomplete
- 882: The input name and address return a different phone number
- 883: The input date-of-birth may have been miskeyed
- 885: The input SSN was issued to a non-US citizen
- 889: The input SSN was issued within the last three years
- 890: The input SSN was issued after age five (post-1990)
- 891: Security Freeze (CRA corrections database)
- 892: Security Alert (CRA corrections database)
- 893: Identity Theft Alert (CRA corrections database)
- 894: Dispute On File (CRA corrections database)
- 895: Unused – For Future Use
- 896: Corrections Database Information Utilized (CRA corrections database)
- 897: Criminal record found
- 898: Lien / Judgment record found
- 899: The input address is verified but may not be primary residence
- 89A: No evidence of property ownership
- 89B: Evidence of historical property ownership but no current record
- 89C: Length of residence
- 89D: Change of address frequency
- 89E: Number of sources confirming identity and current address
- 89F: Date of confirming source update
- 89G: Insufficient Age
- 8IA: The input IP address is unknown
- 89H: Evidence of sub-price credit services solicited
- 89I: No evidence of post-secondary education
- 89J: Age of oldest public record on file
- 8EV: Eviction record found
- 8MI: Multiple identities associated with the input SSN
- 8MN: The input SSN was issued within the last seventeen years
- 8MS: Multiple SSNs reported with applicant
- 8PV: Insufficient property value
- 89K: Address dwelling type
- 89L: Distance between the current and previous address
- 89M: Insufficient evidence of wealth
- 89N: Correctional institution in address history
- 89O: No evidence of phone service at address
- 89P: Number of consumer finance inquiries
- 89Q: Number of inquiries in the last 12 months
- 89R: Length of time on sources confirming identity
- 89S: Type of mortgage
- 89T: Input phone is invalid, non-residential, or disconnected
- 89U: Input address is invalid, non-residential, or undeliverable
- 89V: Input SSN is invalid, recently issued, or inconsistent with date of birth
- 89W: Bankruptcy record on file
- 89X: Insufficient information on file
- 89Y: Insufficient purchase activity reported
description:
type: string
description: Description for the given code
description: Fraud Verification Warning codes
NarrativeCodes:
type: array
minItems: 0
maxItems: 2
items:
type: object
properties:
code:
type: string
description: Code value
description:
type: string
description: >
Narrative codes and descriptions:
- AA: CONSUMER SAYS MERCHANDISE OR SERVICE UNSATISFACTORY
- AB: CONSUMER SAYS ACCOUNT PAID/BEING PAID BY INSURANCE
- AC: CONSUMER SAYS ACCT IS RESPONSIBILITY OF SEPARATED OR DIVORCED SPOUSE
- AE: CONSUMER SAYS ACCT. INVOLVED IN BUSINESS VENTURE HELD PERSONALLY LIAB
- AF: CONSUMER SAYS ACCOUNT INVOLVES LEASE AGREEMENT DISPUTE
- AG: CONSUMER DISPUTES ACCOUNT - LITIGATION PENDING
- AH: CONSUMER SAYS ACCOUNT SLOW DUE TO BILLING DISPUTE WITH CREDITOR
- AI: CONSUMER SAYS ACCOUNT SLOW DUE TO EMPLOYMENT ISSUES
- AJ: CONSUMER SAYS ACCOUNT SLOW DUE TO MEDICAL EXPENSES/ILLNESS
- AL: CONSUMER SAYS WARRANTY DISPUTE
- AM: VOLUNTARY SURRENDER; THERE MAY BE A BALANCE DUE
- AN: INVOLUNTARY REPOSSESSION
- AO: AUTO
- AP: COMMERCIAL ACCOUNT
- AQ: HOUSEHOLD GOODS
- AR: HOME LOAN
- AS: HOME IMPROVEMENT LOAN
- AT: CHECKING ACCOUNT LOAN PLAN
- AU: PERSONAL LOAN
- AV: CHARGE
- AW: SECURED BY HOUSEHOLD GOODS
- AX: PAID BY DEALER
- AY: VOLUNTARILY SURRENDERED – THEN REDEEMED OR REINSTATED
- AZ: AMOUNT IN H/C COLUMN IS CREDIT LIMIT
- BB: CONSUMER DISPUTES THIS ACCOUNT INFORMATION
- BC: ACCOUNT TRANSFERRED OR SOLD
- BD: PAID - CREDIT LINE CLOSED
- BE: CREDIT LINE CLOSED
- BG: CLAIM FILED WITH GOVERNMENT
- BH: DISPUTE - RESOLUTION PENDING
- BK: REDEEMED OR REINSTATED REPOSSESSION
- BL: CONSUMER SAYS ACCOUNT SLOW DUE TO DOMESTIC PROBLEMS
- BM: CONSUMER SAYS PAID ON NOTIFICATION - NO PRIOR KNOWLEDGE OF BALANCE DUE
- BN: CONSUMER SAYS CO-SIGNED ACCOUNT - NOT AWARE OF DELINQUENCY
- BO: CONSUMER SAYS NO STATEMENT RECEIVED DUE TO ADDRESS CHANGE
- BP: CONSUMER SAYS THIS ACCOUNT SPOUSE’S RESPONSIBILITY
- BQ: PAID CHARGE OFF
- BR: FORECLOSURE PROCESS STARTED
- BS: PAID OR BEING PAID BY GOVERNMENT GUARANTOR
- BT: LEASE
- BU: STUDENT LOAN
- BV: CONSUMER DISPUTE FOLLOWING RESOLUTION
- BW: INCLUDED IN BANKRUPTCY
- BX: PAYMENTS MANAGED BY FINANCIAL COUNSELING PROGRAM
- BY: COLLECTION AGENCY ACCOUNT - STATUS UNKNOWN
- BZ: ACCOUNT PAID FOR LESS THAN FULL BALANCE
- CA: CHARGE OFF - MAKING PAYMENTS
- CB: CHARGED OFF - CHECK PRESENTED WAS UNCOLLECTIBLE
- CD: CUSTOMER HAS NOW LOCATED CONSUMER
- CE: REFINANCED
- CF: CLOSED ACCOUNT
- CG: ACCOUNT CLOSED - REASON UNKNOWN
- CH: ACCOUNT PAID AFTER FORECLOSURE STARTED
- CI: INSURANCE CLAIM PENDING
- CJ: CUSTOMER UNABLE TO LOCATE CONSUMER
- CK: DEBIT CARD
- CL: PAID OR BEING PAID BY CO-SIGNER OR GUARANTOR
- CM: ACCOUNT ASSUMED BY ANOTHER PARTY
- CN: PAYING UNDER A PARTIAL PAYMENT AGREEMENT
- CP: CONSUMER SAYS PERSONAL BANKRUPTCY FILED DUE TO BUSINESS FAILURE
- CQ: PLTFF VERIFIED JUDGMENT PAID/SATISFACTION NOT RECORDED WITH COURT
- CS: SECURED CREDIT LINE
- CT: VOLUNTARY
- CU: INVOLUNTARY
- CV: LINE OF CREDIT
- CW: ACCOUNT CLOSED BY CREDIT GRANTOR
- CX: PAYMENT IS PAYROLL DEDUCTIBLE
- CY: ACCOUNT CHARGED TO PROFIT AND LOSS
- CZ: COLLECTION ACCOUNT
- DA: ACCOUNT CLOSED BY CONSUMER
- DB: CHARGED OFF ACCOUNT
- DC: CONSUMER SAYS ACCOUNT NOT PAID PROMPTLY - INSURANCE CLAIM DELAYED
- DD: BALANCE IS DEFICIENCY AMOUNT
- DE: CONSUMER SAYS ACCOUNT PAID IN FULL
- DG: TITLE 1 LOAN
- DH: BALANCE NOT PAID BY INSURANCE
- DI: BALANCE PAID OR BEING PAID BY INSURANCE COMPANY
- DJ: FORECLOSURE
- DK: PAID OR BEING PAID BY GARNISHMENT
- DL: CONSUMER RECALLED TO ACTIVE MILITARY DUTY
- DM: FORFEIT OF DEED IN LIEU OF FORECLOSURE
- DN: BROKEN LEASE AGREEMENT
- DO: BANKRUPTCY CHAPTER 13
- DP: CONVERSION LOSS PAID BY INSURANCE
- DQ: STUDENT LOAN - PAYMENT DEFERRED
- DS: SINGLE PAYMENT LOAN
- DT: AMORTIZED MORTGAGE
- DU: SHERIFF SALE
- DV: AMOUNT IN HIGH CREDIT INCLUDES FINANCE CHARGE
- DW: RETURN MAIL
- DX: BALANCE OWING - AMOUNT NOT REPORTED
- EA: PAID OR MAKING PAYMENTS - NOT ACCORDING TO TERMS OF AGREEMENT
- EB: LEASE - EARLY TERMINATION BY DEFAULT
- EC: HOME EQUITY
- ED: MAKING PAYMENT - FORECLOSURE WAS INITIATED
- EE: SECURED
- EF: REAL ESTATE MORTGAGE
- EG: GUARANTEED STUDENT LOAN
- EH: NATIONAL DIRECT STUDENT LOAN
- EI: CONSUMER DISPUTES ACCOUNT - LITIGATION FILED BY CREDITOR PENDING
- EJ: CONSUMER DISPUTES ACCOUNT - LITIGATION FILED BY CONSUMER PENDING
- EK: CHILD/FAMILY SUPPORT OBLIGATION
- EL: DEFENDANT VERIFIED ITEM PD/SATISFACTION NOT RECORDED WITH COURT
- EM: VOLUNTARY RETURN OF PURCHASE
- EP: FIXED RATE
- EQ: VARIABLE/ADJUSTABLE RATE
- ER: PAID COLLECTION
- ES: CHARGED BACK TO DEALER
- ET: PAID REPOSSESSION
- EU: SEE CONSUMER STATEMENT
- EV: BANKRUPTCY CHAPTER 11
- EX: UNSECURED
- EY: BUSINESS ACCOUNT - PERSONAL GUARANTEE
- EZ: HAS CO-SIGNER
- FA: CLOSED OR PAID ACCOUNT/ZERO BALANCE
- FB: INCLUDED IN ORDERLY PAYMENT DEBT
- FC: CREDIT LINE SUSPENDED
- FD: DEFAULTED STUDENT LOAN
- FE: CREDIT CARD
- FF: CONSUMER SAYS ACCOUNT NOT HIS/HERS
- FG: CONSUMER SAYS ACCOUNT NEVER LATE
- FH: CONSUMER SAYS THIS PUBLIC RECORD NOT HIS/HERS
- FL: CONSUMER SAYS THIS PUBLIC RECORD FILED IN ERROR
- FM: CONSUMER SAYS THIS PUBLIC RECORD ITEM SATISFIED OR RELEASED
- FO: CONSUMER SAYS BANKRUPTCY DISCHARGED
- FP: CONSUMER SAYS BANKRUPTCY DISMISSED
- FQ: CONSUMER SAYS CURRENT RATE/STATUS INCORRECT
- FR: MAKING PAYMENTS
- FS: ANNUAL PAYMENT
- FU: CHARGED OFF CHECKING ACCOUNT
- FV: PLTFF VERIFIED LIEN PD/RELEASE NOT RECORDED WITH COURT
- FW: CONSUMER DISPUTES – REINVESTIGATION IN PROGRESS
- FX: ACCOUNT LISTED AS PUBLIC RECORD
- FZ: ACCOUNT REINSTATED WITH LENDER
- GA: PAID BY COLLATERAL
- GB: ACCOUNT BEING PAID THROUGH WEP
- GC: ACCOUNT BEING PAID THROUGH FINANCIAL COUNSELING PLAN
- GD: ACCOUNT PAID THROUGH FINANCIAL COUNSELING PLAN
- GE: CONSUMER DISPUTES THIS ITEM
- GF: REAFFIRMATION OF DEBT
- GH: PLAINTIFF/COUNSEL VERIFIED JUDGEMENT PAID
- GI: UTILITY
- GJ: STUDENT LOAN ASSIGNED TO GOVERNMENT
- GK: AFFECTED BY NATURAL DISASTER
- GL: FIRST PAYMENT NEVER RECEIVED
- GM: ACCOUNT ACQUIRED BY FDIC/NCUA
- GN: GOVERNMENT DEBT
- GO: DEBT CONSOLIDATION
- GP: MANUFACTURED HOUSING
- GQ: RECREATIONAL MERCHANDISE
- GR: SECURED CREDIT CARD
- GS: MEDICAL
- HF: ACCOUNT CLOSED BY CONSUMER
- HL: 100% PAYMENT TO CREDITORS FILING CLAIMS
- HO: RETURNED CHECK
- HP: FHA MORTGAGE
- HQ: VA MORTGAGE
- HR: CONVENTIONAL MORTGAGE
- HS: SECOND MORTGAGE
- HT: AGRICULTURAL
- HU: COMMERCIAL MORTGAGE-INDIVIDUAL LIABLE, COMPANY IS GUARANTOR
- HV: DEPOSIT RELATED
- HW: CHILD/FAMILY SUPPORT
- HX: TRANSFERRED TO RECOVERY
- IB: LEASE - FULL TERMINATION
- IC: LEASE - EARLY TERMINATION
- ID: STATUS PENDING
- IE: FANNIE MAE ACCOUNT
- IF: FREDDIE MAC ACCOUNT
- IG: PREPAID LEASE
- IH: CONSUMER PAYS BALANCE IN FULL EACH MONTH
- II: PRINCIPAL DEFERRED/INTEREST PAYMENT ONLY
- IJ: PAYMENT DEFERRED
- IK: BANKRUPTCY VOLUNTARILY WITHDRAWN
- IL: BANKRUPTCY CHAPTER 7
- IM: BANKRUPTCY CHAPTER 12
- IN: REAFFIRMATION OF DEBT RESCINDED
- IP: CONSUMER DISPUTES THIS ACCOUNT INFORMATION
- IQ: CONSUMER DISPUTES AFTER RESOLUTION
- IR: ACCOUNT CLOSED AT CONSUMER’S REQUEST
- IT: ACCOUNT ACQUIRED FROM ANOTHER LENDER
- IZ: AMOUNT IN HIGH CREDIT IS ORIGINAL CHARGE-OFF AMOUNT
- JA: ELECTION OF REMEDY
- JD: CONSUMER DECEASED
- JE: ADJUSTMENT PENDING
- JF: INACTIVE ACCOUNT
- JG: DOLLAR AMOUNT IN EXCESS OF $1 BILLION
- JH: PERSONAL RECEIVERSHIP – REPAYMENT MANAGED BY COURT TRUSTEE
- JI: GUARANTEED/INSURED
- JJ: TIME SHARE LOAN
- JK: 120 DAYS PAST DUE
- JL: 150 DAYS PAST DUE
- JM: 180 DAYS OR MORE PAST DUE
- JN: PARTIALLY SECURED
- JO: NOTE LOAN
- JP: RENTAL AGREEMENT
- JQ: AUTO LEASE
- JR: TELECOMMUNICATIONS/CELLULAR
- JS: UNSECURED GOVERNMENT LOAN
- JT: SECURED GOVERNMENT LOAN
- JU: HOME EQUITY LINE OF CREDIT
- JV: ATTORNEY FEES
- JW: CONSTRUCTION LOAN
- JX: FLEXIBLE SPENDING CREDIT CARD
- JY: COMBINED CREDIT PLAN
- JZ: DEBT BUYER ACCOUNT
- KA: INSTALLMENT SALES CONTRACT
- KB: BANKRUPTCY PETITION
- KC: BANKRUPTCY DISCHARGED
- KD: BANKRUPTCY COMPLETED
- KE: LEASE ASSUMPTION
- KF: ACCOUNT PREVIOUSLY IN DISPUTE – NOW RESOLVED BY DATA FURNISHER
- KG: CHAPTER 7 BANKRUPTCY DISMISSED
- KH: CHAPTER 11 BANKRUPTCY DISMISSED
- KI: CHAPTER 12 BANKRUPTCY DISMISSED
- KJ: CHAPTER 13 BANKRUPTCY DISMISSED
- KK: CHAPTER 7 BANKRUPTCY WITHDRAWN
- KL: CHAPTER 11 BANKRUPTCY WITHDRAWN
- KM: CHAPTER 12 BANKRUPTCY WITHDRAWN
- KN: CHAPTER 13 BANKRUPTCY WITHDRAWN
- KO: BANKRUPCTY – UNDESIGNATED CHAPTER
- KP: ACCOUNT CLOSED DUE TO INACTIVITY
- KQ: CREDIT LINE NO LONGER AVAILABLE - IN REPAYMENT PHASE
- KR: CREDIT LINE REDUCED DUE TO COLLATERAL DEPRECIATION
- KS: CREDIT LINE SUSPENDED DUE TO COLLATERAL DEPRECIATION
- KT: COLLATERAL RELEASED BY CREDITOR/BALANCE OWING
- KU: LOAN MODIFIED UNDER A FEDERAL GOVERNMENT PLAN
- KV: LOAN MODIFIED
- KW: ACCOUNT IN FORBEARANCE
- KZ: ACCOUNT PAID IN FULL; WAS A VOLUNTARY SURRENDER
- LB: HOMEOWNERS ASSOCIATION (HOA)
AlertContactAddress:
type: object
description: Contact's address information
properties:
addressLine1:
type: string
maxLength: 50
description: House number, street name & street type
addressLine2:
type: string
maxLength: 25
description: Apartment, condo, suite, or unit number
cityName:
type: string
maxLength: 20
description: City name
stateAbbreviation:
type: string
maxLength: 2
description: State name's abbreviation
zipCode:
type: string
maxLength: 9
description: Zip code
countryCode:
type: string
maxLength: 3
description: Country code
AddressRequest:
type: object
required:
- identifier
- city
- state
properties:
identifier:
type: string
example: ["Current", "Co-applicant", "Property address"]
description: Address type of the report subject
houseNumber:
type: string
maxLength: 10
description: House number
quadrant:
type: string
maxLength: 2
description: Quadrant
streetName:
type: string
maxLength: 26
description: Street name
streetType:
type: string
maxLength: 2
description: Street type
example: ["AV", "ST"]
apartmentNumber:
type: string
maxLength: 5
description: Apartment/Condo/Unit number
city:
type: string
maxLength: 20
description: City name
state:
type: string
maxLength: 2
description: State abbreviation
zip:
type: string
maxLength: 9
description: Zip code
Address:
type: object
description: Subject's address(es) information
properties:
addressType:
type: string
maxLength: 2
enum:
- "current"
- "former"
- "additional"
description: >
The address type:
- current: Current Address. A maximum of 1 current Address can be returned per report
- former: Former Address. A maximum of 1 former Address can be returned per report
- additional: Additional Address. A maximum of 8 additional Addresses can be returned per report
houseNumber:
type: string
description: Street Number/House number
maxLength: 10
streetName:
type: string
maxLength: 26
description: Street name
streetType:
type: string
description: Street type/Direction/Apartment number
maxLength: 26
cityName:
type: string
maxLength: 20
description: City name
stateAbbreviation:
type: string
maxLength: 2
description: State abbreviation
zipCode:
type: string
maxLength: 9
description: Zip code
rentOwnBuy:
type: string
maxLength: 1
description: Rent/Own/Buy
sourceOfAddress:
type: object
description: The source of address data
properties:
code:
type: string
maxLength: 1
description: Code value
description:
type: string
description: >
Sources of address:
- C: EQUIFAX
- D: OTH/Sys-Sys
- T: AUT
telephoneNumber:
$ref: '#/components/schemas/TelephoneNumber'
sourceOfTelephoneNumber:
type: object
description: Source of Telephone data
properties:
code:
type: string
maxLength: 1
description: Code value
description:
type: string
description: >
Sources of telephone number:
- 1: Special Vendor
- 2: Equifax
- 3: OTH/Sys-Sys
- 4: Automated Update Indicator
addressVarianceIndicator:
type: object
description: >
The Address Variance Indicator will alert you to the differences between the address submitted current and other addresses displayed on the consumer report.The Address Variance Indicator will return a code, for each address displayed on the report, informing you of the degree to which the first address submitted in the inquiry matched the address on the Equifax database.
Address Variance Indicator is an optional feature offered by Equifax.
Please contact your Equifax Sales Associate for additional information and activation.
properties:
code:
type: string
maxLength: 1
description: Code value
description:
type: string
addressLine1:
type: string
maxLength: 62
description: Combination of address components
dateFirstReported:
description: First date the address was reported to Equifax
allOf:
- $ref: '#/components/schemas/FullDate'
dateLastReported:
description: Last date the address was reported to Equifax
allOf:
- $ref: '#/components/schemas/FullDate'
dateTelephoneReported:
description: Date the telephone number was reported to Equifax
allOf:
- $ref: '#/components/schemas/FullDate'
APIErrorResponse:
type: object
required:
- efxErrorCode
- description
properties:
efxErrorCode:
type: number
description: Error code
description:
type: string
additionalErrorDetails:
$ref: '#/components/schemas/AdditionalErrorDetails'
AdditionalErrorDetails:
type: object
required:
- status
- timestamp
description: Additional error details
properties:
status:
type: number
description: HTTP status code
errors:
$ref: '#/components/schemas/ErrorResponse'
code:
type: number
description: Internal code to identify the error
message:
type: string
description: Short error message
timeStamp:
type: string
description: Date and time when the error occurred
ErrorResponse:
type: array
items:
type: object
required:
- code
- errorType
description: >
properties:
code:
type: string
description: >
Error code types\:
CERR: Code Error Message Response
NARRATIVE CODES:
- 001: CUSTOMER NUMBER/SECURITY CODE INVALID (DIAL)
- 002: TELEPROCESSING TYPE CODE INVALID
- 003: CUSTOMER CODE INVALID
- 004: INPUT FORMAT CODE INVALID
- 005: OUTPUT FORMAT CODE INVALID
- 006: NUMBER OF MONTHS TO COUNT INQUIRIES INVALID (DIAL)
- 007: NUMBER OF MONTHS TO COUNT MAXIMUM DELINQUENCIES INV. (DIAL)
- 008: INPUT FORMAT INVALID
- 009: ADDITIONAL INPUT INVALID UNTIL DIAL COMPLETE
- 010: CUSTOMER NUMBER INVALID/DTEC ONLY (DIAL)
- 015: ACCOUNT SUSPENDED DUE TO NON-PAYMENT. CALL 800-685-6000 FOR RESOLUTION
- 00A: MULTIPLE CODE INVALID
- 00B: INPUT FORMAT INVALID
- 00C: FILE SELECTION CODE INVALID
- 00D: DIAL LINE DOES NOT END WITH A PERIOD
- 00E: INVALID PLAIN/TRADITIONAL LANGUAGE REQUEST CODE - FIXED INPUT
- 00F: INDUSTRY CODE INVALID FOR ACCESS CODE (DIAL-ACIS)
REQUEST CODES:
- 021: SEGMENT COUNT NOT EQUAL TO SEGMENTS IN
- 026: CUSTOMER NUMBER/SECURITY CODE INVALID (IDNT)
- 027: SEGMENT COUNT NON-NUMERIC
- 028: ECOA INQUIRY TYPE INVALID
- 029: TYPE OF PROCESSING CODE INVALID
- 032: INDUSTRY CODE INVALID FOR ACCESS CODE (IDNT-ACIS)
- 033: CUSTOMER NUMBER INVALID/DTEC ONLY (IDNT)
- 034: INVALID OPTIONAL FEATURE CODE
- 02A: NUMBER OF MONTHS TO COUNT INQUIRIES INVALID (IDNT)
- 02B: NUMBER OF MONTHS TO COUNT MAXIMUM DELINQ. INV. IDNT
- 02C: INVALID SEGMENT IDENTIFIER
- 02D: MINNESOTA FILES ARE BLOCKED
- 02E: CHARACTER NOT IN STANDARD CHARACTER SET
- 02F: INCOMPLETE IDNT SEGMENT
- 03A: IMPROPER DELIMITER ON ACRO INQUIRY
- 03B: CUSTOMER NUMBER IS EQUAL TO ‘IG’, ‘IL’ ‘IZ’ AND ‘ZB’ AND A PERMISSIBLE PURPOSE CODE IS NOT PRESENT
- 03C: REQUIRED FIELD IS MISSING ON “EU” SEGMENT
- 03D: MORE THAN ONE “EU” SEGMENT IS PRESENT ON IDNT
- 03E: CUSTOMER NUMBER IS NOT EQUAL TO A “ZB” AND “EU” IS PRESENT
- 03F: VERMONT FILES BLOCKED - CONTACT 1-800-685-5000 FOR REQUIRED CERTIFICATION
- 0E0: \*\*END USER NOT IDENTIFIED – CONTACT 1-800-685-5000 FOR INFORMATION\*\*
- 0EF: PERMISSIBLE PURPOSE CODE IS REQUIRED FOR THIS PRODUCT
- 0F1: PRODUCT NOT AVAILABLE TO INSURANCE INDUSTRY
The following refers to the first 42 bytes of the record:
- 101: INVALID CUSTOMER NUMBER
- 102: INVALID TELEPROCESSING TYPE
- 103: INVALID COMPANY CODE
- 104: INVALID INPUT/OUTPUT CODE
- 105: ACCOUNT SUSPENDED DUE TO NON-PAYMENT. CALL 800-685-6000 FOR RESOLUTION
- 1F1: LINE ONE DUPLICATE LINES
- 1F2: LINE ONE UNACCEPTABLE FOREIGN BUREAU LINE
- 1F3: LINE ONE INVALID LINE MNEMONIC
- 1F4: LINE ONE LONGER THAN 80 BYTES
Error codes used in the segment’s name portion:
- 201: INVALID LAST NAME
- 202: INVALID FIRST NAME
- 203: INVALID MIDDLE NAME
- 204: INVALID SUFFIX
- 205: INVALID SPOUSE NAME
- 2F1: LINE TWO DUPLICATE LINES
- 2F2: LINE TWO UNACCEPTABLE FOREIGN BUREAU LINE
- 2F3: LINE TWO INVALID LINE MNEMONIC
- 2F4: LINE TWO LONGER THAN 80 BYTES
Inquiry Search Information Error Codes:
- 031: INVALID PHONE NUMBER
- 401: INVALID SUBJECT SOCIAL SECURITY NUMBER
- 403: INVALID SUBJECT AGE
- 404: INVALID SUBJECT SEX
- 405: INVALID SPOUSE BIRTH DATE
- 406: INVALID SPOUSE SOCIAL SECURITY NUMBER
- 407: INVALID NUMBER OF DEPENDENTS
- 408: INVALID MARITAL STATUS
- 4F1: LINE FOUR DUPLICATE LINES
- 4F2: LINE FOUR UNACCEPTABLE FOREIGN BUREAU LINE
- 4F3: LINE FOUR INVALID LINE MNEMONIC
- 4F4: LINE FOUR LONGER THAN 80 BYTES
- 022: MAXIMUM NUMBER OF “AD” SEGMENTS EXCEEDED
- 025: AD SEGMENT DOES NOT FOLLOW IDNT SEGMENT
The codes to follow refer to the first AD Segment:
- 301: INVALID STREET NUMBER
- 302: INVALID STREET NAME
- 303: INVALID STREET TYPE
- 304: INVALID CITY NAME
- 305: INVALID STATE CODE
- 306: INVALID ZIP CODE
- 307: INVALID FILE SINCE
- 308: INVALID R-O-B CODE
- 3F1: LINE THREE DUPLICATE LINES
- 3F2: LINE THREE UNACCEPTABLE FOREIGN BUREAU LINE
- 3F3: LINE THREE INVALID LINE MNEMONIC
- 3F4: LINE THREE LONGER THAN 80 BYTES
These next codes refer to the second AD Segment:
- 501: INVALID FORMER ADDRESS STREET NUMBER
- 503: INVALID FORMER ADDRESS STREET TYPE
- 504: INVALID FORMER ADDRESS CITY NAME
- 505: INVALID FORMER ADDRESS STATE CODE
- 506: INVALID FORMER ADDRESS ZIP CODE
- 507: INVALID FORMER ADDRESS DATE SINCE
- 508: INVALID FORMER ADDRESS R-O-B CODE
- 5F1: LINE FIVE DUPLICATE LINES
- 5F2: LINE FIVE UNACCEPTABLE FOREIGN BUREAU LINE
- 5F3: LINE FIVE INVALID LINE MNEMONIC
- 5F4: LINE FIVE LONGER THAN 80 BYTES
- 6F1: LINE SIX DUPLICATE LINES
- 6F2: LINE SIX UNACCEPTABLE FOREIGN BUREAU LINE
- 6F3: LINE SIX INVALID LINE MNEMONIC
- 6F4: LINE SIX LONGER THAN 80 BYTES
JA Segment Error Conditions:
- 032: MORE THAN ONE JA SEGMENT WAS FOUND
ES Segment Error Conditions:
- 023: MORE THAN ONE ES SEGMENT ENCOUNTERED
- 024: ES SEGMENT DOES NOT FOLLOW AD SEGMENT
- 030: EMPLOYER NAME IS LONGER THAN 35 BYTES
EU Segment Error Conditions:
- 03B: CUSTOMER NUMBER IS EQUAL TO ‘IG’, ‘IL’, ‘IZ’ AND ‘ZB’ AND A PERMISSIBLE PURPOSE CODE IS NOT PRESENT
- 03C: TEXT OR PERMISSIBLE PURPOSE CODE NOT ON “EU” SEG
- 03D: MORE THAN ONE “EU” SEGMENT IS PRESENT ON IDNT
- 03E: CUSTOMER NUMBER IS NOT EQUAL TO A “ZB” AND “EU” IS PRESENT
- 0E0: \*\* END USER NOT IDENTIFIED – CONTACT 1-800-685-5000 FOR INFORMATION \*\*
- 0EF: PERMISSIBLE PURPOSE CODE IS REQUIRED FOR THIS PRODUCT
- 0F0: INVALID FCRA PERMISSIBLE PURPOSE OR GLB EXCEPTION FOR PRODUCT REQUESTED
- 0F1: PRODUCT NOT AVAILABLE TO INSURANCE INDUSTRY
- 602: LINE 6 FIELD 2 PROBLEM (DIAL SEGMENT = LINE 1)
- 702: INCORRECT PERMISSIBLE PURPOSE CODE
PC Segment Error Conditions:
- 0E2: INVALID PC CODE
- 0E3: MULTIPLE PC CODES NOT ALLOWED
- 0E4: ZIP CODE IS A REQUIRED FIELD
- 0E5: PC SEGMENT REQUIRED WITH PI
- 0E6: ONLY ONE PC SEGMENT ALLOWED