Get a specific Metro2 credit report for a specific account.

GET /accounts/{account_id}/credit_reports/{credit_report_id}

This will return a Metro2 credit report that corresponds with the passed Credit Report ID. Relevant IDs for an account's historical Metro2 credit reports can be obtained from the accounts/{account_id}/credit_reports/list route.

Path parameters

Responses

  • Hide response attributes Show response attributes object
    • account_id string Required

      The Canopy-generated ID for the account

    • credit_report_id string Required

      The Canopy-generated ID for the statement

    • report_transunion string | null

      Transunion Metro2 credit report

    • report_equifax string | null

      Equifax Metro2 credit report

    • report_experian string | null

      Experian Metro2 credit report

    • activity_date string(date) | null

      Signifies date of most recent update to accounts. If accounts are updated on different dates, use most recent. A future date should not be reported.

    • date_created string(date) Required

      Contains the date the media was generated. A future date should not be reported.

    • program_date string(date) | null

      Contains the date your reporting format was developed.

    • program_revision_date string(date) | null

      Contains the last date your reporting format was revised.

    • reporter_name string | null

      Contains the name of the processing company sending the data; i.e., data furnisher or processor.

    • reporter_address string | null

      Contains the complete mailing address of the processing company; i.e., street address, city, state and zip code.

    • Contains the telephone number (Area Code + number) of the company sending the data; i.e., data furnisher or processor.

    • consumer_account_number string | null Required

      The account_id for the individual reported. This is the canonical Canopy account id.

    • portfolio_type string Required

      Contains the one-character abbreviation for type of portfolio

      Values are C, I, M, O, or R.

    • account_type string Required

      Report the specific code that identifies the account classification.

      Values are 01, 15, or 18.

    • date_opened string(date) Required

      Report the date the account was originally opened. Retain the original Date Opened regardless of future activity, such as transfer, refinance, lost or stolen card, etc.

    • credit_limit integer Required

      Total amount (in truncated dollars) that the account can borrow.

    • highest_credit integer Required

      If a revolving account, highest credit is the peak balance within the statement cycle. If an installment account, it is the original loan amount.

    • terms_duration string Required

      Contains the duration of credit extended, or LOC if revolving account

    • terms_frequency string Required

      Report the frequency for payments due.

      Values are P, W, B, E, M, L, Q, T, S, or Y.

    • Report the dollar amount of the scheduled monthly payment due for this reporting period, whether principal, interest only or a combination of the two.

    • actual_payment_amount integer Required

      Report the dollar amount of the monthly payment actually received for this reporting period in whole dollars only.

    • account_status string Required

      Contains the status code that properly identifies the current condition of the account as of the Date of Account Information.

      Values are 11, 13, 71, 78, 80, 82, 83, 84, 64, 97, or DF.

    • payment_rating string | null

      The Payment Rating contains a code that properly identifies whether the account was current, past due, in collections or charged off prior to the status and within the current month’s reporting period.

      Values are null, 0, 1, 2, 3, 4, 5, 6, G, or L.

    • Contains up to 24 months of consecutive payment activity for the previous 24 reporting periods prior to the Date of Account Information being reported.

    • Used in conjunction with Account Status and Payment Rating to further define the account (e.g., closed accounts or adjustments pending).

      Values are null, AP, M, or AU.

    • Allows the reporting of a condition that is required for legal compliance.

      Values are null or XA.

    • current_balance integer Required

      Report the outstanding current dollar balance on the account as of the Date of Account Information.

    • amount_past_due integer Required

      Report the total amount of payments that are 30 days or more past due in whole dollars only.

    • For Status Codes 64 and 97 (all portfolio types), report the original amount charged to loss, regardless of the declining balance. Whole dollars

    • date_of_account_info string(date) Required

      Date of reporting.

    • first_delinquency_date string(date) | null

      Indicates the first date of delinquency in a given cycle.

    • date_closed string(date) | null

      For all portfolio types, contains the date the account was closed to further purchases, paid in full, transferred or sold.

    • last_payment_date string(date) | null

      Report the date the most recent payment was received, whether full or partial payment is made.

    • consumer_primary object Required
      Hide consumer_primary attributes Show consumer_primary attributes object
      • name_first string Required

        Customer's first name. Primary account holder or controlling officer name for Business customers.

      • Customer's middle name. Primary account holder or controlling officer name for Business customers.

      • name_last string Required

        Customer's last name. Primary account holder or controlling officer name for Business customers.

      • Suffix to the customer's name

      • ssn string

        Social security number of the customer

      • date_of_birth string(date) Required

        Customer's date of birth in ISO 8601 format

      • ecoa_code string Required

        Defines the relationship of the primary consumer to the account and designates the account as joint, individual, etc., in compliance with the Equal Credit Opportunity Act.

        Values are 1, 2, 3, 5, 7, T, X, W, or Z.

      • Contains a value that indicates a special condition of the account that applies to the associated consumer.

      • Customer's phone number in E.164 format

      • address_line_one string Required

        Address line one.

      • Address line two.

      • address_city string Required

        Address city.

      • address_state string Required

        Address state.

      • address_zip string Required

        Five digit zipcode or nine digit 'ZIP+4'

  • Unauthorized.

  • Forbidden.

  • Statement not found

  • Too many requests.

  • Unexpected Error.

GET /accounts/{account_id}/credit_reports/{credit_report_id}
curl \
 -X GET https://sandbox-api.canopyservicing.com/accounts/31mNprzLd2bKl6koVna68ARM/credit_reports/31mNprzLd2bKl6koVna68ARM \
 -H "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "account_id": "31mNprzLd2bKl6koVna68ARM",
  "credit_report_id": "31mNprzLd2bKl6koVna68ARM",
  "report_transunion": "see here for example: https://github.com/moov-io/metro2/blob/master/test/testdata/unpacked_fixed_file.dat",
  "report_equifax": "see here for example: https://github.com/moov-io/metro2/blob/master/test/testdata/unpacked_fixed_file.dat",
  "report_experian": "see here for example: https://github.com/moov-io/metro2/blob/master/test/testdata/unpacked_fixed_file.dat",
  "activity_date": "2013-01-13",
  "date_created": "2013-01-13",
  "program_date": "2013-01-13",
  "program_revision_date": "2013-01-13",
  "reporter_name": "Canopy Servicing",
  "reporter_address": "350 5th Ave, New York, NY 10118, United States",
  "reporter_telephone_number": "5104120012",
  "consumer_account_number": "31mNprzLd2bKl6koVna68ARM",
  "portfolio_type": "C",
  "account_type": "18",
  "date_opened": "2013-01-13",
  "credit_limit": 500,
  "highest_credit": 500,
  "terms_duration": 24,
  "terms_frequency": "M",
  "scheduled_monthly_payment_amount": 37,
  "actual_payment_amount": 50,
  "account_status": "11",
  "payment_rating": "0",
  "payment_history_profile": "BBBBBBBBBBBBBBBBBBBBBBB0",
  "special_comment_code": null,
  "compliance_condition_code": null,
  "current_balance": 1000,
  "amount_past_due": 37,
  "original_charge_off_amount": 37,
  "date_of_account_info": "2013-01-30",
  "first_delinquency_date": "2013-01-30",
  "date_closed": "2013-01-30",
  "last_payment_date": "2013-01-30",
  "consumer_primary": {
    "name_first": "Miriam",
    "name_middle": "Louise",
    "name_last": "Trevino",
    "name_suffix": "Jr",
    "ssn": "888-88-8888",
    "date_of_birth": "1985-06-20",
    "ecoa_code": "1",
    "consumer_indicator_code": "string",
    "phone_number": "+14105556789",
    "address_line_one": "12 Strawberry Road",
    "address_line_two": "Suite 101",
    "address_city": "Atlanta",
    "address_state": "GA",
    "address_zip": "99999-1000"
  }
}
Response examples (200)
{
  "account_id": "31mNprzLd2bKl6koVna68ARM",
  "credit_report_id": "31mNprzLd2bKl6koVna68ARM",
  "report_transunion": "see here for example: https://github.com/moov-io/metro2/blob/master/test/testdata/unpacked_fixed_file.dat",
  "report_equifax": "see here for example: https://github.com/moov-io/metro2/blob/master/test/testdata/unpacked_fixed_file.dat",
  "report_experian": "see here for example: https://github.com/moov-io/metro2/blob/master/test/testdata/unpacked_fixed_file.dat",
  "activity_date": "2013-01-13",
  "date_created": "2013-01-13",
  "program_date": "2013-01-13",
  "program_revision_date": "2013-01-13",
  "reporter_name": "Canopy Servicing",
  "reporter_address": "350 5th Ave, New York, NY 10118, United States",
  "reporter_telephone_number": "5104120012",
  "consumer_account_number": "31mNprzLd2bKl6koVna68ARM",
  "portfolio_type": "C",
  "account_type": "18",
  "date_opened": "2013-01-13",
  "credit_limit": 500,
  "highest_credit": 500,
  "terms_duration": 24,
  "terms_frequency": "M",
  "scheduled_monthly_payment_amount": 37,
  "actual_payment_amount": 50,
  "account_status": "11",
  "payment_rating": "0",
  "payment_history_profile": "BBBBBBBBBBBBBBBBBBBBBBB0",
  "special_comment_code": null,
  "compliance_condition_code": null,
  "current_balance": 1000,
  "amount_past_due": 37,
  "original_charge_off_amount": 37,
  "date_of_account_info": "2013-01-30",
  "first_delinquency_date": "2013-01-30",
  "date_closed": "2013-01-30",
  "last_payment_date": "2013-01-30",
  "consumer_primary": {
    "name_first": "Miriam",
    "name_middle": "Louise",
    "name_last": "Trevino",
    "name_suffix": "Jr",
    "ssn": "888-88-8888",
    "date_of_birth": "1985-06-20",
    "ecoa_code": "1",
    "consumer_indicator_code": "string",
    "phone_number": "+14105556789",
    "address_line_one": "12 Strawberry Road",
    "address_line_two": "Suite 101",
    "address_city": "Atlanta",
    "address_state": "GA",
    "address_zip": "99999-1000"
  }
}