> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spojit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Stripe

> Customers, charges, payment intents, invoices, products, and subscriptions.

The Stripe connector lets your workflows manage payments, customers, invoices, products, and subscriptions through the Stripe API.

<Note>
  For the full API reference, see the [Stripe API documentation](https://docs.stripe.com/api).
</Note>

<Snippet file="connection-note.mdx" />

## Connection setup

<Steps>
  <Step title="Get your API key">
    Log in to the [Stripe Dashboard](https://dashboard.stripe.com) and navigate to **Developers > API Keys**. Copy your **Secret key** (starts with `sk_live_` for production or `sk_test_` for testing).
  </Step>

  <Step title="Add the connection in Spojit">
    Go to **Connections** in Spojit, click **Add Connection**, select **Stripe**, and enter:

    * **Secret Key**: Your Stripe secret key (starts with `sk_live_` or `sk_test_`)
  </Step>
</Steps>

<Tip>
  There is also a **Stripe (Official MCP)** connector available that uses Stripe's hosted MCP server for full API coverage. Use this connector for common operations with a streamlined tool set, or the official MCP connector for advanced use cases.
</Tip>

## Tools

### Customers

<AccordionGroup>
  <Accordion title="list-customers: List customers">
    <ParamField body="limit" type="number" default="10">
      Number of results (max 100).
    </ParamField>

    <ParamField body="starting_after" type="string">
      Cursor for pagination. Pass the ID of the last customer from the previous page.
    </ParamField>

    <ParamField body="email" type="string">
      Filter by exact email address.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "limit": 2,
      "email": "jennyrosen@example.com"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "object": "list",
      "url": "/v1/customers",
      "has_more": false,
      "data": [
        {
          "id": "cus_NffrFeUfNV2Hib",
          "object": "customer",
          "address": null,
          "balance": 0,
          "created": 1680893993,
          "currency": null,
          "default_source": null,
          "delinquent": false,
          "description": null,
          "email": "jennyrosen@example.com",
          "invoice_prefix": "0759376C",
          "invoice_settings": {
            "custom_fields": null,
            "default_payment_method": null,
            "footer": null,
            "rendering_options": null
          },
          "livemode": false,
          "metadata": {},
          "name": "Jenny Rosen",
          "next_invoice_sequence": 1,
          "phone": null,
          "preferred_locales": [],
          "shipping": null,
          "tax_exempt": "none",
          "test_clock": null
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="get-customer: Get a customer by ID">
    <ParamField body="id" type="string" required>
      Customer ID (starts with `cus_`).
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "id": "cus_NffrFeUfNV2Hib"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "id": "cus_NffrFeUfNV2Hib",
      "object": "customer",
      "address": null,
      "balance": 0,
      "created": 1680893993,
      "currency": null,
      "default_source": null,
      "delinquent": false,
      "description": null,
      "email": "jennyrosen@example.com",
      "invoice_prefix": "0759376C",
      "invoice_settings": {
        "custom_fields": null,
        "default_payment_method": null,
        "footer": null,
        "rendering_options": null
      },
      "livemode": false,
      "metadata": {},
      "name": "Jenny Rosen",
      "next_invoice_sequence": 1,
      "phone": null,
      "preferred_locales": [],
      "shipping": null,
      "tax_exempt": "none",
      "test_clock": null
    }
    ```
  </Accordion>

  <Accordion title="create-customer: Create a new customer">
    <ParamField body="email" type="string">
      Customer email address.
    </ParamField>

    <ParamField body="name" type="string">
      Customer full name.
    </ParamField>

    <ParamField body="phone" type="string">
      Phone number.
    </ParamField>

    <ParamField body="description" type="string">
      Internal description or notes.
    </ParamField>

    <ParamField body="metadata" type="object">
      Key-value pairs for additional information.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "name": "Jenny Rosen",
      "email": "jennyrosen@example.com"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "id": "cus_NffrFeUfNV2Hib",
      "object": "customer",
      "address": null,
      "balance": 0,
      "created": 1680893993,
      "currency": null,
      "default_source": null,
      "delinquent": false,
      "description": null,
      "email": "jennyrosen@example.com",
      "invoice_prefix": "0759376C",
      "invoice_settings": {
        "custom_fields": null,
        "default_payment_method": null,
        "footer": null,
        "rendering_options": null
      },
      "livemode": false,
      "metadata": {},
      "name": "Jenny Rosen",
      "next_invoice_sequence": 1,
      "phone": null,
      "preferred_locales": [],
      "shipping": null,
      "tax_exempt": "none",
      "test_clock": null
    }
    ```
  </Accordion>
</AccordionGroup>

### Charges

<AccordionGroup>
  <Accordion title="list-charges: List charges">
    <ParamField body="limit" type="number" default="10">
      Number of results (max 100).
    </ParamField>

    <ParamField body="starting_after" type="string">
      Cursor for pagination.
    </ParamField>

    <ParamField body="customer" type="string">
      Filter by customer ID.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "limit": 3
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "object": "list",
      "url": "/v1/charges",
      "has_more": false,
      "data": [
        {
          "id": "ch_3MmlLrLkdIwHu7ix0snN0B15",
          "object": "charge",
          "amount": 1099,
          "amount_captured": 1099,
          "amount_refunded": 0,
          "application": null,
          "application_fee": null,
          "application_fee_amount": null,
          "balance_transaction": "txn_3MmlLrLkdIwHu7ix0uke3Ezy",
          "billing_details": {
            "address": {
              "city": null,
              "country": null,
              "line1": null,
              "line2": null,
              "postal_code": null,
              "state": null
            },
            "email": null,
            "name": null,
            "phone": null
          },
          "calculated_statement_descriptor": "Stripe",
          "captured": true,
          "created": 1679090539,
          "currency": "usd",
          "customer": null,
          "description": null,
          "disputed": false,
          "failure_balance_transaction": null,
          "failure_code": null,
          "failure_message": null,
          "fraud_details": {},
          "livemode": false,
          "metadata": {},
          "on_behalf_of": null,
          "outcome": {
            "network_status": "approved_by_network",
            "reason": null,
            "risk_level": "normal",
            "risk_score": 32,
            "seller_message": "Payment complete.",
            "type": "authorized"
          },
          "paid": true,
          "payment_intent": null,
          "payment_method": "card_1MmlLrLkdIwHu7ixIJwEWSNR",
          "payment_method_details": {
            "card": {
              "brand": "visa",
              "checks": {
                "address_line1_check": null,
                "address_postal_code_check": null,
                "cvc_check": null
              },
              "country": "US",
              "exp_month": 3,
              "exp_year": 2024,
              "fingerprint": "mToisGZ01V71BCos",
              "funding": "credit",
              "installments": null,
              "last4": "4242",
              "mandate": null,
              "network": "visa",
              "three_d_secure": null,
              "wallet": null
            },
            "type": "card"
          },
          "receipt_email": null,
          "receipt_number": null,
          "receipt_url": "https://pay.stripe.com/receipts/payment/CAcaFwoVYWNjdF...",
          "refunded": false,
          "review": null,
          "shipping": null,
          "source_transfer": null,
          "statement_descriptor": null,
          "statement_descriptor_suffix": null,
          "status": "succeeded",
          "transfer_data": null,
          "transfer_group": null
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="create-charge: Create a charge">
    <ParamField body="amount" type="number" required>
      Amount in the smallest currency unit (e.g., cents for USD).
    </ParamField>

    <ParamField body="currency" type="string" required>
      Three-letter ISO currency code (e.g., `usd`, `eur`).
    </ParamField>

    <ParamField body="customer" type="string">
      Customer ID to charge.
    </ParamField>

    <ParamField body="source" type="string">
      Payment source token or ID.
    </ParamField>

    <ParamField body="description" type="string">
      Charge description.
    </ParamField>

    <ParamField body="metadata" type="object">
      Key-value pairs for additional information.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "amount": 1099,
      "currency": "usd",
      "source": "tok_visa"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "id": "ch_3MmlLrLkdIwHu7ix0snN0B15",
      "object": "charge",
      "amount": 1099,
      "amount_captured": 1099,
      "amount_refunded": 0,
      "application": null,
      "application_fee": null,
      "application_fee_amount": null,
      "balance_transaction": "txn_3MmlLrLkdIwHu7ix0uke3Ezy",
      "billing_details": {
        "address": {
          "city": null,
          "country": null,
          "line1": null,
          "line2": null,
          "postal_code": null,
          "state": null
        },
        "email": null,
        "name": null,
        "phone": null
      },
      "calculated_statement_descriptor": "Stripe",
      "captured": true,
      "created": 1679090539,
      "currency": "usd",
      "customer": null,
      "description": null,
      "disputed": false,
      "failure_balance_transaction": null,
      "failure_code": null,
      "failure_message": null,
      "fraud_details": {},
      "livemode": false,
      "metadata": {},
      "outcome": {
        "network_status": "approved_by_network",
        "reason": null,
        "risk_level": "normal",
        "risk_score": 32,
        "seller_message": "Payment complete.",
        "type": "authorized"
      },
      "paid": true,
      "payment_intent": null,
      "payment_method": "card_1MmlLrLkdIwHu7ixIJwEWSNR",
      "refunded": false,
      "status": "succeeded"
    }
    ```
  </Accordion>
</AccordionGroup>

### Payment Intents

<AccordionGroup>
  <Accordion title="list-payment-intents: List payment intents">
    <ParamField body="limit" type="number" default="10">
      Number of results (max 100).
    </ParamField>

    <ParamField body="starting_after" type="string">
      Cursor for pagination.
    </ParamField>

    <ParamField body="customer" type="string">
      Filter by customer ID.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "limit": 3
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "object": "list",
      "url": "/v1/payment_intents",
      "has_more": false,
      "data": [
        {
          "id": "pi_3MtwBwLkdIwHu7ix28a3tqPa",
          "object": "payment_intent",
          "amount": 2000,
          "amount_capturable": 0,
          "amount_details": {
            "tip": {}
          },
          "amount_received": 0,
          "application": null,
          "application_fee_amount": null,
          "automatic_payment_methods": {
            "enabled": true
          },
          "canceled_at": null,
          "cancellation_reason": null,
          "capture_method": "automatic",
          "client_secret": "pi_3MtwBwLkdIwHu7ix28a3tqPa_secret_YrKJUKribcBjcG8HVhfZluoGH",
          "confirmation_method": "automatic",
          "created": 1680800504,
          "currency": "usd",
          "customer": null,
          "description": null,
          "last_payment_error": null,
          "latest_charge": null,
          "livemode": false,
          "metadata": {},
          "next_action": null,
          "payment_method": null,
          "payment_method_options": {
            "card": {
              "installments": null,
              "mandate_options": null,
              "network": null,
              "request_three_d_secure": "automatic"
            },
            "link": {
              "persistent_token": null
            }
          },
          "payment_method_types": [
            "card",
            "link"
          ],
          "processing": null,
          "receipt_email": null,
          "setup_future_usage": null,
          "shipping": null,
          "source": null,
          "statement_descriptor": null,
          "statement_descriptor_suffix": null,
          "status": "requires_payment_method",
          "transfer_data": null,
          "transfer_group": null
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="create-payment-intent: Create a payment intent">
    <ParamField body="amount" type="number" required>
      Amount in the smallest currency unit.
    </ParamField>

    <ParamField body="currency" type="string" required>
      Three-letter ISO currency code.
    </ParamField>

    <ParamField body="customer" type="string">
      Customer ID.
    </ParamField>

    <ParamField body="payment_method_types" type="string[]">
      Accepted payment method types (e.g., `["card"]`). Defaults to `["card"]`.
    </ParamField>

    <ParamField body="description" type="string">
      Description of the payment.
    </ParamField>

    <ParamField body="metadata" type="object">
      Key-value pairs for additional information.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "amount": 2000,
      "currency": "usd",
      "payment_method_types": ["card"]
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "id": "pi_3MtwBwLkdIwHu7ix28a3tqPa",
      "object": "payment_intent",
      "amount": 2000,
      "amount_capturable": 0,
      "amount_details": {
        "tip": {}
      },
      "amount_received": 0,
      "application": null,
      "application_fee_amount": null,
      "automatic_payment_methods": {
        "enabled": true
      },
      "canceled_at": null,
      "cancellation_reason": null,
      "capture_method": "automatic",
      "client_secret": "pi_3MtwBwLkdIwHu7ix28a3tqPa_secret_YrKJUKribcBjcG8HVhfZluoGH",
      "confirmation_method": "automatic",
      "created": 1680800504,
      "currency": "usd",
      "customer": null,
      "description": null,
      "last_payment_error": null,
      "latest_charge": null,
      "livemode": false,
      "metadata": {},
      "next_action": null,
      "payment_method": null,
      "payment_method_options": {
        "card": {
          "installments": null,
          "mandate_options": null,
          "network": null,
          "request_three_d_secure": "automatic"
        },
        "link": {
          "persistent_token": null
        }
      },
      "payment_method_types": [
        "card",
        "link"
      ],
      "processing": null,
      "receipt_email": null,
      "setup_future_usage": null,
      "shipping": null,
      "source": null,
      "statement_descriptor": null,
      "statement_descriptor_suffix": null,
      "status": "requires_payment_method",
      "transfer_data": null,
      "transfer_group": null
    }
    ```
  </Accordion>
</AccordionGroup>

### Invoices

<AccordionGroup>
  <Accordion title="list-invoices: List invoices">
    <ParamField body="limit" type="number" default="10">
      Number of results (max 100).
    </ParamField>

    <ParamField body="starting_after" type="string">
      Cursor for pagination.
    </ParamField>

    <ParamField body="customer" type="string">
      Filter by customer ID.
    </ParamField>

    <ParamField body="status" type="string">
      Filter by status: `draft`, `open`, `paid`, `uncollectible`, or `void`.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "limit": 3,
      "status": "draft"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "object": "list",
      "url": "/v1/invoices",
      "has_more": false,
      "data": [
        {
          "id": "in_1MtHbELkdIwHu7ixl4OzzPMv",
          "object": "invoice",
          "account_country": "US",
          "account_name": "Stripe Docs",
          "account_tax_ids": null,
          "amount_due": 0,
          "amount_paid": 0,
          "amount_remaining": 0,
          "amount_shipping": 0,
          "application": null,
          "attempt_count": 0,
          "attempted": false,
          "auto_advance": false,
          "automatic_tax": {
            "enabled": false,
            "liability": null,
            "status": null
          },
          "billing_reason": "manual",
          "collection_method": "charge_automatically",
          "created": 1680644467,
          "currency": "usd",
          "custom_fields": null,
          "customer": "cus_NeZwdNtLEOXuvB",
          "customer_address": null,
          "customer_email": "jennyrosen@example.com",
          "customer_name": "Jenny Rosen",
          "customer_phone": null,
          "customer_shipping": null,
          "customer_tax_exempt": "none",
          "customer_tax_ids": [],
          "default_payment_method": null,
          "default_source": null,
          "default_tax_rates": [],
          "description": null,
          "discounts": [],
          "due_date": null,
          "ending_balance": null,
          "footer": null,
          "hosted_invoice_url": null,
          "invoice_pdf": null,
          "issuer": {
            "type": "self"
          },
          "lines": {
            "object": "list",
            "data": [],
            "has_more": false,
            "total_count": 0,
            "url": "/v1/invoices/in_1MtHbELkdIwHu7ixl4OzzPMv/lines"
          },
          "livemode": false,
          "metadata": {},
          "next_payment_attempt": null,
          "number": null,
          "on_behalf_of": null,
          "payment_settings": {
            "default_mandate": null,
            "payment_method_options": null,
            "payment_method_types": null
          },
          "period_end": 1680644467,
          "period_start": 1680644467,
          "post_payment_credit_notes_amount": 0,
          "pre_payment_credit_notes_amount": 0,
          "receipt_number": null,
          "shipping_cost": null,
          "shipping_details": null,
          "starting_balance": 0,
          "statement_descriptor": null,
          "status": "draft",
          "status_transitions": {
            "finalized_at": null,
            "marked_uncollectible_at": null,
            "paid_at": null,
            "voided_at": null
          },
          "subtotal": 0,
          "subtotal_excluding_tax": 0,
          "total": 0,
          "total_excluding_tax": 0,
          "webhooks_delivered_at": 1680644467
        }
      ]
    }
    ```
  </Accordion>

  <Accordion title="create-invoice: Create an invoice">
    <ParamField body="customer" type="string" required>
      Customer ID.
    </ParamField>

    <ParamField body="auto_advance" type="boolean" default="true">
      Whether to automatically finalize and attempt payment.
    </ParamField>

    <ParamField body="collection_method" type="string" default="charge_automatically">
      Collection method: `charge_automatically` or `send_invoice`.
    </ParamField>

    <ParamField body="description" type="string">
      Invoice description.
    </ParamField>

    <ParamField body="metadata" type="object">
      Key-value pairs for additional information.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "customer": "cus_NeZwdNtLEOXuvB"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "id": "in_1MtHbELkdIwHu7ixl4OzzPMv",
      "object": "invoice",
      "account_country": "US",
      "account_name": "Stripe Docs",
      "account_tax_ids": null,
      "amount_due": 0,
      "amount_paid": 0,
      "amount_remaining": 0,
      "amount_shipping": 0,
      "application": null,
      "attempt_count": 0,
      "attempted": false,
      "auto_advance": false,
      "automatic_tax": {
        "enabled": false,
        "liability": null,
        "status": null
      },
      "billing_reason": "manual",
      "collection_method": "charge_automatically",
      "created": 1680644467,
      "currency": "usd",
      "custom_fields": null,
      "customer": "cus_NeZwdNtLEOXuvB",
      "customer_address": null,
      "customer_email": "jennyrosen@example.com",
      "customer_name": "Jenny Rosen",
      "customer_phone": null,
      "customer_shipping": null,
      "customer_tax_exempt": "none",
      "customer_tax_ids": [],
      "default_payment_method": null,
      "default_source": null,
      "default_tax_rates": [],
      "description": null,
      "discounts": [],
      "due_date": null,
      "ending_balance": null,
      "footer": null,
      "hosted_invoice_url": null,
      "invoice_pdf": null,
      "issuer": {
        "type": "self"
      },
      "lines": {
        "object": "list",
        "data": [],
        "has_more": false,
        "total_count": 0,
        "url": "/v1/invoices/in_1MtHbELkdIwHu7ixl4OzzPMv/lines"
      },
      "livemode": false,
      "metadata": {},
      "next_payment_attempt": null,
      "number": null,
      "on_behalf_of": null,
      "payment_settings": {
        "default_mandate": null,
        "payment_method_options": null,
        "payment_method_types": null
      },
      "period_end": 1680644467,
      "period_start": 1680644467,
      "post_payment_credit_notes_amount": 0,
      "pre_payment_credit_notes_amount": 0,
      "receipt_number": null,
      "shipping_cost": null,
      "shipping_details": null,
      "starting_balance": 0,
      "statement_descriptor": null,
      "status": "draft",
      "status_transitions": {
        "finalized_at": null,
        "marked_uncollectible_at": null,
        "paid_at": null,
        "voided_at": null
      },
      "subtotal": 0,
      "subtotal_excluding_tax": 0,
      "total": 0,
      "total_excluding_tax": 0,
      "webhooks_delivered_at": 1680644467
    }
    ```
  </Accordion>
</AccordionGroup>

### Products

<AccordionGroup>
  <Accordion title="list-products: List products">
    <ParamField body="limit" type="number" default="10">
      Number of results (max 100).
    </ParamField>

    <ParamField body="starting_after" type="string">
      Cursor for pagination.
    </ParamField>

    <ParamField body="active" type="boolean">
      Filter by active status.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "limit": 3,
      "active": true
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "object": "list",
      "url": "/v1/products",
      "has_more": false,
      "data": [
        {
          "id": "prod_NWjs8kKbJWmuuc",
          "object": "product",
          "active": true,
          "created": 1678833149,
          "default_price": null,
          "description": null,
          "images": [],
          "marketing_features": [],
          "livemode": false,
          "metadata": {},
          "name": "Gold Plan",
          "package_dimensions": null,
          "shippable": null,
          "statement_descriptor": null,
          "tax_code": null,
          "unit_label": null,
          "updated": 1678833149,
          "url": null
        }
      ]
    }
    ```
  </Accordion>
</AccordionGroup>

### Subscriptions

<AccordionGroup>
  <Accordion title="list-subscriptions: List subscriptions">
    <ParamField body="limit" type="number" default="10">
      Number of results (max 100).
    </ParamField>

    <ParamField body="starting_after" type="string">
      Cursor for pagination.
    </ParamField>

    <ParamField body="customer" type="string">
      Filter by customer ID.
    </ParamField>

    <ParamField body="status" type="string">
      Filter by status: `active`, `past_due`, `unpaid`, `canceled`, `incomplete`, `incomplete_expired`, `trialing`, or `all`.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "limit": 3,
      "status": "active"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "object": "list",
      "url": "/v1/subscriptions",
      "has_more": false,
      "data": [
        {
          "id": "sub_1MowQVLkdIwHu7ixeRlqHVzs",
          "object": "subscription",
          "application": null,
          "application_fee_percent": null,
          "automatic_tax": {
            "enabled": false,
            "liability": null
          },
          "billing_cycle_anchor": 1679609767,
          "cancel_at": null,
          "cancel_at_period_end": false,
          "canceled_at": null,
          "cancellation_details": {
            "comment": null,
            "feedback": null,
            "reason": null
          },
          "collection_method": "charge_automatically",
          "created": 1679609767,
          "currency": "usd",
          "customer": "cus_Na6dX7aXxi11N4",
          "days_until_due": null,
          "default_payment_method": null,
          "default_source": null,
          "default_tax_rates": [],
          "description": null,
          "discounts": null,
          "ended_at": null,
          "invoice_settings": {
            "issuer": {
              "type": "self"
            }
          },
          "items": {
            "object": "list",
            "data": [
              {
                "id": "si_Na6dzxczY5fwHx",
                "object": "subscription_item",
                "created": 1679609768,
                "current_period_end": 1682288167,
                "current_period_start": 1679609767,
                "metadata": {},
                "plan": {
                  "id": "price_1MowQULkdIwHu7ixraBm864M",
                  "object": "plan",
                  "active": true,
                  "amount": 1000,
                  "amount_decimal": "1000",
                  "billing_scheme": "per_unit",
                  "created": 1679609766,
                  "currency": "usd",
                  "interval": "month",
                  "interval_count": 1,
                  "livemode": false,
                  "metadata": {},
                  "nickname": null,
                  "product": "prod_Na6dGcTsmU0I4R",
                  "usage_type": "licensed"
                },
                "price": {
                  "id": "price_1MowQULkdIwHu7ixraBm864M",
                  "object": "price",
                  "active": true,
                  "billing_scheme": "per_unit",
                  "created": 1679609766,
                  "currency": "usd",
                  "livemode": false,
                  "metadata": {},
                  "nickname": null,
                  "product": "prod_Na6dGcTsmU0I4R",
                  "recurring": {
                    "interval": "month",
                    "interval_count": 1,
                    "trial_period_days": null,
                    "usage_type": "licensed"
                  },
                  "type": "recurring",
                  "unit_amount": 1000,
                  "unit_amount_decimal": "1000"
                },
                "quantity": 1,
                "subscription": "sub_1MowQVLkdIwHu7ixeRlqHVzs",
                "tax_rates": []
              }
            ],
            "has_more": false,
            "total_count": 1,
            "url": "/v1/subscription_items?subscription=sub_1MowQVLkdIwHu7ixeRlqHVzs"
          },
          "latest_invoice": "in_1MowQWLkdIwHu7ixuzkSPfKd",
          "livemode": false,
          "metadata": {},
          "next_pending_invoice_item_invoice": null,
          "on_behalf_of": null,
          "pause_collection": null,
          "payment_settings": {
            "payment_method_options": null,
            "payment_method_types": null,
            "save_default_payment_method": "off"
          },
          "pending_invoice_item_interval": null,
          "pending_setup_intent": null,
          "pending_update": null,
          "schedule": null,
          "start_date": 1679609767,
          "status": "active",
          "test_clock": null,
          "transfer_data": null,
          "trial_end": null,
          "trial_settings": {
            "end_behavior": {
              "missing_payment_method": "create_invoice"
            }
          },
          "trial_start": null
        }
      ]
    }
    ```
  </Accordion>
</AccordionGroup>

### Advanced

<AccordionGroup>
  <Accordion title="raw-api-request: Make an arbitrary API request">
    Send a request to any Stripe API endpoint.

    <ParamField body="method" type="string" required>
      HTTP method: `GET`, `POST`, or `DELETE`.
    </ParamField>

    <ParamField body="path" type="string" required>
      API path (e.g., `/v1/customers`, `/v1/charges`).
    </ParamField>

    <ParamField body="body" type="object">
      Request body (form-encoded parameters).
    </ParamField>

    <ParamField body="query" type="object">
      Query string parameters.
    </ParamField>

    **Example request:**

    ```json theme={null}
    {
      "method": "GET",
      "path": "/v1/balance"
    }
    ```

    **Example response:**

    ```json theme={null}
    {
      "object": "balance",
      "available": [
        {
          "amount": 0,
          "currency": "usd",
          "source_types": {
            "card": 0
          }
        }
      ],
      "livemode": false,
      "pending": [
        {
          "amount": 0,
          "currency": "usd",
          "source_types": {
            "card": 0
          }
        }
      ]
    }
    ```
  </Accordion>
</AccordionGroup>