How to Attest Different Tradeline Categories
A tradeline can fall into multiple categories. For each applicable category, the following requirements must be met. The category can be determined by using the Me query, under tradelines > edges > node > category.
Rent
- Primary Residence Confirmation - the rental property must be confirmed to be the consumer's primary residence by including the
isPrimaryAddress
field in therent
agreement, set totrue
- No Mortgage Confirmation - consumer confirms they do not have an active mortgage by including the
hasOtherMortgageOrRent
field in therent
agreement, set tofalse
. - Lease Start Date - required for Metro2 reporting. Included in the
input
via theleaseStartDate
field.
mutation OpenTradeline {
openTradeline(
input: {
leaseStartDate: "2025-01-01"
agreements: {
rent: { isPrimaryAddress: true, hasOtherMortgageOrRent: false }
}
tradelineId: "0195dd14-2c8f-7ec3-8b0e-7db586a75df5"
}
) {
attestation {
agreements {
rent {
isPrimaryAddress
hasOtherMortgageOrRent
}
}
}
}
}
Utility
- Utility Type - consumer selects the type of utility, set via the
UtilityType
property. See Utility Type for possible values. - Primary Residence Confirmation - the rental property must be confirmed to be the consumer's primary residence with including the
isPrimaryAddress
field in therent
agreement - Payment Frequency - this does not have to be set in the mutation. It is determined from the tradeline's
paymentFrequency
field, found under the tradelines in the Me query.
mutation OpenTradeline {
openTradeline(
input: {
agreements: { utility: { isPrimaryAddress: true } }
tradelineId: "0195dd14-2d29-7578-8029-24e4818084c5"
utilityTypes: ELECTRIC
}
) {
attestation {
agreements {
utility {
isPrimaryAddress
}
}
}
}
}
Telco
- Service Phone Number - the phone number linked to the telecom bill. Set the
servicePhone
field in the mutation to the phone number. - Payment Frequency - this does not have to be set in the mutation. It is determined from the tradeline's
paymentFrequency
field, found under the tradelines in the Me query.
mutation OpenTradeline {
openTradeline(
input: {
servicePhone: "1234567890"
agreements: {}
tradelineId: "0195dd14-2d0d-7139-af5a-b615455228e8"
}
) {
attestation {
agreements {
rent {
isPrimaryAddress
hasOtherMortgageOrRent
}
utility {
isPrimaryAddress
}
}
}
}
}
Updated 5 days ago