Get information on a specific line item for a specific account

GET /accounts/{account_id}/line_items/{line_item_id}

Path parameters

Query parameters

  • limit integer

    The maximum number of line items to be returned. Defaults to 100.

  • Pass the value from the paging response body in your previous request. If not provided, the zero-indexed starting point will be used. Either starting_after or ending_before may be provided, but not both.

  • Pass the value from the paging response body in your previous request. If not provided, the zero-indexed starting point will be used. Either starting_after or ending_before may be provided, but not both.

Responses

  • Array of Line Items where the last element is the root line item whose details were requested.

    Hide response attributes Show response attributes object
    • results array[object] | null

      An array of information for all line items within the requested range.

      Not more than 1000 elements.

      Hide results attributes Show results attributes array[object] | null
      • 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

    • paging object

      Pagination Information.

      Hide paging attributes Show paging attributes object
      • Use this to drive your next request if you want the next page of results

      • Use this to drive your next request if you want the previous page of results

      • has_more boolean

        Indicates whether there are additional values beyond the ending index of the paginated results.

  • Unauthorized.

  • Forbidden.

  • Line Items not found

  • Too many requests.

  • Unexpected Error.

GET /accounts/{account_id}/line_items/{line_item_id}
curl \
 -X GET https://sandbox-api.canopyservicing.com/accounts/31mNprzLd2bKl6koVna68ARM/line_items/31mNprzLd2bKl6koVna68ARM \
 -H "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "results": [
    {
      "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"
        }
      ]
    }
  ],
  "paging": {
    "starting_after": "31mNprzLd2bKl6koVna68ARM",
    "ending_before": "31mNprzLd2bKl6koVna68ARM",
    "has_more": false
  }
}
Response examples (200)
{
  "results": [
    {
      "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"
        }
      ]
    }
  ],
  "paging": {
    "starting_after": "31mNprzLd2bKl6koVna68ARM",
    "ending_before": "31mNprzLd2bKl6koVna68ARM",
    "has_more": false
  }
}