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 the rent agreement, set to true
  • No Mortgage Confirmation - consumer confirms they do not have an active mortgage by including the hasOtherMortgageOrRent field in the rent agreement, set to false.
  • Lease Start Date - required for Metro2 reporting. Included in the input via the leaseStartDate 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 the rent 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
                }
            }
        }
    }
}