Get a specific statement for a specific account.

GET /accounts/{account_id}/statements/{statement_id}

This will return a statement that corresponds with the passed Statement ID. Relevant IDs for an account's historical statements can be obtained from the accounts/{account_id}/statements/list route.

Path parameters

Responses

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

      The Canopy-generated ID for the account

    • statement_id string Required

      The Canopy-generated ID for the statement

    • pdf_url string | null

      Secure, temporary URL for the generated PDF

    • Hide account_overview attributes Show account_overview attributes object
      • If applicable, the Date-Time the purchase window for the account ends.

      • promo_purchase_window_exclusive_end string(date-time) | null

        If applicable, the Date-Time the purchase window for the account ends.

      • promo_inclusive_start string(date-time) | null

        If applicable, the Date-Time the promo period for the account starts.

      • promo_exclusive_end string(date-time) | null

        If applicable, the Date-Time the promo period for the account ends.

      • The Status of the Account. Active upon account creation.

        Values are ACTIVE, SUSPENDED, or CLOSED. Default value is ACTIVE.

      • The subtype of the Status of the Account. Null upon account creation.

        Values are , INACTIVITY, INELIGIBLE, DELINQUENT, CHARGE_OFF, GRANTOR_REQUEST, BANKRUPTCY, PAID_OFF, CUSTOMER_REQUEST_PENDING_PAYOFF, GRANTOR_REQUEST_PENDING_PAYOFF, DECEASED, RISK_REVIEW, FRAUD, CUSTOMER_REQUEST, or RISK. Default value is empty.

    • Hide open_to_buy attributes Show open_to_buy attributes object
      • credit_limit_cents integer | null

        Total Amount (in cents) that this account can borrow.

        Default value is 0.

      • total_charges_cents integer | null

        Sum of all charges that occurred on the account since account origination.

        Default value is 0.

      • The total available credit balance (in cents) for the account.

        Default value is 0.

      • open_to_buy_cents integer | null

        If applicable, the total amount of available funds for continued purchase following a purchase window pattern, where payments made do not replenish amount available for purchase.

        Default value is 0.

    • Hide cycle_summary attributes Show cycle_summary attributes object
      • cycle_inclusive_start string(date-time) | null

        The inclusive starting Date-Time that defines which transactions are part of this statement.

      • cycle_exclusive_end string(date-time) | null

        The inclusive ending Date-Time that defines which transactions are part of this statement.

      • Sum of all charges that occurred on the account during the billing cycle.

        Default value is 0.

      • Sum of all loans amounts that were initiated on the account during the billing cycle.

        Default value is 0.

      • Sum of all returns that occurred on the account during the billing cycle.

        Default value is 0.

      • Sum of all payments that occurred on the account during the billing cycle.

        Default value is 0.

      • Sum of all payment reversal amounts that occurred on the account during the billing cycle.

        Default value is 0.

      • Sum of all debit adjustment amounts that occurred on the account during the billing cycle.

        Default value is 0.

      • Sum of all credit adjustment amounts that occurred on the account during the billing cycle.

        Default value is 0.

      • Total interest accrued during the billing cycle.

        Default value is 0.

      • The current AM interest balance of the line item. Canopy tracks interest during an amortization period separately from deferred interest accrued during a revolving period.

        Default value is 0.

      • Total interest accrued during the billing cycle.

        Default value is 0.

      • Total interest accrued during the billing cycle. Canopy tracks deferred interest during an amortization period separately from deferred interest accrued during a revolving period.

        Default value is 0.

      • Total late fees incurred during the billing cycle.

        Default value is 0.

      • Total payment reversal fees incurred during the billing cycle.

        Default value is 0.

      • Total deferred interest that was forgiven on the account during the billing cycle.

        Default value is 0.

    • Hide min_pay_due attributes Show min_pay_due attributes object
      • min_pay_cents integer Required

        Total amount due for the billing cycle, summing cycle principal, interest, deferred interest, and fees outstanding.

      • min_pay_due_at string(date-time) | null Required

        The Date-Time the payment for this billing cycle is due.

    • Hide additional_min_pay_details attributes Show additional_min_pay_details attributes object
    • Hide balance_summary attributes Show balance_summary attributes object
    • payoff object
      Hide payoff attributes Show payoff attributes object
    • line_items array[object]

      A snapshot of all line items that occurred during the cycle and were VALID at the time of Statement cut.

      Not more than 1000 elements.

      Hide line_items attributes Show line_items attributes array[object]
      • account_id string Required

        The account associated with the line item

      • line_item_id string Required

        The ID associated with the line item

      • effective_at string(date-time)

        The Date-Time that this line item became/becomes active

      • created_at string(date-time)

        The Date-Time which the line item was created.

      • product_id string Required

        the Product ID of the account

      • Hide line_item_overview attributes Show line_item_overview attributes object
        • the corresponding Status for a line item

          Values are AUTHORIZED, DECLINED, INVALID, OFFSET, PENDING, POSTED, REVERSED, ROLLED, SETTLED, SPLIT_INVALID, SPLIT_VALID, VALID, or VOID. Default value is VALID.

        • line_item_type string Required

          The Line Item Type. i.e. CHARGE, PAYMENT, CREDIT_OFFSET, DEBIT_OFFSET, MANUAL_FEE.

        • description string | null

          A description of this particular line item if any. More common for adjustments.

      • Hide line_item_summary attributes Show line_item_summary attributes object
        • The originating amount of money (in cents) relating to this line item.

        • The current balance of the line item, which accounts for interest accrued per the product's interest policy and the account's interest rate attribute.

        • The principal balance of the line item.

        • The current interest balance of the line item.

        • The current AM interest balance of the line item. Canopy tracks interest during an amortization period separately from deferred interest accrued during a revolving period.

        • The current deferred interest balance of the line item.

        • The current AM deferred interest balance of the line item. Canopy tracks deferred interest during an amortization period separately from deferred interest accrued during a revolving period.

        • The sum (in cents) of all payments towards interest charges, if any, applied to this line item to date

      • merchant_data object | null

        Merchant information if applicable.

        Hide merchant_data attributes Show merchant_data attributes object | null
      • Hide issuer_processor_details attribute Show issuer_processor_details attribute object | null
        • lithic object
          Hide lithic attributes Show lithic attributes object
          • last_four string | null

            Last four digits of the card against which the spend was made.

          • transaction_token string(uuid) | null

            The external unique identifier of the transaction.

          • card_token string(uuid) | null

            The external unique identifier of the card related to this line item.

      • external_fields array[object] | null

        An array of static references to fields in a third party system.

        Not more than 1000 elements.

        Hide external_fields attributes Show external_fields attributes array[object] | null
        • key string

          Key - i.e. Name of the External Party

        • value string

          Value - i.e. External Account ID

  • Unauthorized.

  • Forbidden.

  • Statement not found

  • Too many requests.

  • Unexpected Error.

GET /accounts/{account_id}/statements/{statement_id}
curl \
 -X GET https://sandbox-api.canopyservicing.com/accounts/31mNprzLd2bKl6koVna68ARM/statements/31mNprzLd2bKl6koVna68ARM \
 -H "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "account_id": "31mNprzLd2bKl6koVna68ARM",
  "statement_id": "31mNprzLd2bKl6koVna68ARM",
  "pdf_url": "https://bucket.s3.statement.pdf",
  "account_overview": {
    "promo_purchase_window_inclusive_start": "2015-08-31T10:49:44.461+00:00",
    "promo_purchase_window_exclusive_end": "2015-08-31T10:49:44.461+00:00",
    "promo_inclusive_start": "2015-08-31T10:49:44.461+00:00",
    "promo_exclusive_end": "2015-08-31T10:49:44.461+00:00",
    "account_status": "SUSPENDED",
    "account_status_subtype": "BANKRUPTCY"
  },
  "open_to_buy": {
    "credit_limit_cents": 400000,
    "total_charges_cents": 800000,
    "available_credit_cents": 600000,
    "open_to_buy_cents": 600000
  },
  "cycle_summary": {
    "cycle_inclusive_start": "2023-05-04T09:42:00+00:00",
    "cycle_exclusive_end": "2023-05-04T09:42:00+00:00",
    "cycle_charges_cents": 700000,
    "cycle_loans_cents": 700000,
    "cycle_charge_returns_cents": 100000,
    "cycle_payments_cents": 200000,
    "cycle_payment_reversals_cents": 200000,
    "cycle_debit_adjustments_cents": 40000,
    "cycle_credit_adjustments_cents": 53000,
    "cycle_interest_cents": 110000,
    "cycle_am_interest_cents": 0,
    "cycle_deferred_interest_cents": 300000,
    "cycle_am_deferred_interest_cents": 300000,
    "cycle_late_fees_cents": 300000,
    "cycle_payment_reversals_fees_cents": 300000,
    "cycle_waived_deferred_interest_cents": 40000
  },
  "min_pay_due": {
    "min_pay_cents": 160000,
    "min_pay_due_at": "2019-10-18T23:04:48.321+00:00"
  },
  "additional_min_pay_details": {
    "min_pay_charges_principal_cents": 100000,
    "min_pay_interest_cents": 30000,
    "min_pay_am_interest_cents": 0,
    "min_pay_deferred_cents": 10000,
    "min_pay_am_deferred_interest_cents": 200,
    "min_pay_fees_cents": 20000,
    "previous_min_pay_cents": 400000
  },
  "balance_summary": {
    "charges_principal_cents": 900000,
    "loans_principal_cents": 900000,
    "interest_balance_cents": 100000,
    "am_interest_balance_cents": 100000,
    "deferred_interest_balance_cents": 700000,
    "am_deferred_interest_balance_cents": 40000,
    "fees_balance_cents": 700000,
    "total_balance_cents": 400000
  },
  "payoff": {
    "total_payoff_cents": 900000,
    "expected_remaining_payment_amount_cents": 1100000
  },
  "line_items": [
    {
      "account_id": 4,
      "line_item_id": 2,
      "effective_at": "2018-07-20T09:12:30+00:00",
      "created_at": "2018-06-20T09:12:30+00:00",
      "product_id": "li_4Yxb5",
      "line_item_overview": {
        "line_item_status": "VALID",
        "line_item_type": "CHARGE",
        "description": "Refund for invalid purchase"
      },
      "line_item_summary": {
        "original_amount_cents": 2484,
        "balance_cents": 3600,
        "principal_cents": 2400,
        "interest_balance_cents": 1100,
        "am_interest_balance_cents": 0,
        "deferred_interest_balance_cents": 200,
        "am_deferred_interest_balance_cents": 0,
        "total_interest_paid_to_date_cents": -16
      },
      "merchant_data": {
        "name": "string",
        "id": "string",
        "mcc_code": "string",
        "phone_number": "string"
      },
      "issuer_processor_details": {
        "lithic": {
          "last_four": 3324,
          "transaction_token": "33xd08bc-d100-488y-bb93-f8a1f081ff0e",
          "card_token": "c6cd08bc-c524-48f5-b64d-f79ec0810df4"
        }
      },
      "external_fields": [
        {
          "key": "Globex Card Processing Account ID",
          "value": "22445702-a389-431f-927d-07b8d0750787"
        }
      ]
    }
  ]
}
Response examples (200)
{
  "account_id": "31mNprzLd2bKl6koVna68ARM",
  "statement_id": "31mNprzLd2bKl6koVna68ARM",
  "pdf_url": "https://bucket.s3.statement.pdf",
  "account_overview": {
    "promo_purchase_window_inclusive_start": "2015-08-31T10:49:44.461+00:00",
    "promo_purchase_window_exclusive_end": "2015-08-31T10:49:44.461+00:00",
    "promo_inclusive_start": "2015-08-31T10:49:44.461+00:00",
    "promo_exclusive_end": "2015-08-31T10:49:44.461+00:00",
    "account_status": "SUSPENDED",
    "account_status_subtype": "BANKRUPTCY"
  },
  "open_to_buy": {
    "credit_limit_cents": 400000,
    "total_charges_cents": 800000,
    "available_credit_cents": 600000,
    "open_to_buy_cents": 600000
  },
  "cycle_summary": {
    "cycle_inclusive_start": "2025-05-04T09:42:00Z",
    "cycle_exclusive_end": "2025-05-04T09:42:00Z",
    "cycle_charges_cents": 700000,
    "cycle_loans_cents": 700000,
    "cycle_charge_returns_cents": 100000,
    "cycle_payments_cents": 200000,
    "cycle_payment_reversals_cents": 200000,
    "cycle_debit_adjustments_cents": 40000,
    "cycle_credit_adjustments_cents": 53000,
    "cycle_interest_cents": 110000,
    "cycle_am_interest_cents": 0,
    "cycle_deferred_interest_cents": 300000,
    "cycle_am_deferred_interest_cents": 300000,
    "cycle_late_fees_cents": 300000,
    "cycle_payment_reversals_fees_cents": 300000,
    "cycle_waived_deferred_interest_cents": 40000
  },
  "min_pay_due": {
    "min_pay_cents": 160000,
    "min_pay_due_at": "2019-10-18T23:04:48.321+00:00"
  },
  "additional_min_pay_details": {
    "min_pay_charges_principal_cents": 100000,
    "min_pay_interest_cents": 30000,
    "min_pay_am_interest_cents": 0,
    "min_pay_deferred_cents": 10000,
    "min_pay_am_deferred_interest_cents": 200,
    "min_pay_fees_cents": 20000,
    "previous_min_pay_cents": 400000
  },
  "balance_summary": {
    "charges_principal_cents": 900000,
    "loans_principal_cents": 900000,
    "interest_balance_cents": 100000,
    "am_interest_balance_cents": 100000,
    "deferred_interest_balance_cents": 700000,
    "am_deferred_interest_balance_cents": 40000,
    "fees_balance_cents": 700000,
    "total_balance_cents": 400000
  },
  "payoff": {
    "total_payoff_cents": 900000,
    "expected_remaining_payment_amount_cents": 1100000
  },
  "line_items": [
    {
      "account_id": 4,
      "line_item_id": 2,
      "effective_at": "2018-07-20T09:12:30+00:00",
      "created_at": "2018-06-20T09:12:30+00:00",
      "product_id": "li_4Yxb5",
      "line_item_overview": {
        "line_item_status": "VALID",
        "line_item_type": "CHARGE",
        "description": "Refund for invalid purchase"
      },
      "line_item_summary": {
        "original_amount_cents": 2484,
        "balance_cents": 3600,
        "principal_cents": 2400,
        "interest_balance_cents": 1100,
        "am_interest_balance_cents": 0,
        "deferred_interest_balance_cents": 200,
        "am_deferred_interest_balance_cents": 0,
        "total_interest_paid_to_date_cents": -16
      },
      "merchant_data": {
        "name": "string",
        "id": "string",
        "mcc_code": "string",
        "phone_number": "string"
      },
      "issuer_processor_details": {
        "lithic": {
          "last_four": 3324,
          "transaction_token": "33xd08bc-d100-488y-bb93-f8a1f081ff0e",
          "card_token": "c6cd08bc-c524-48f5-b64d-f79ec0810df4"
        }
      },
      "external_fields": [
        {
          "key": "Globex Card Processing Account ID",
          "value": "22445702-a389-431f-927d-07b8d0750787"
        }
      ]
    }
  ]
}