Introduction
    Authentication
    Errors
    Expanding Responses
    Idempotent requests
    Include-dependent response values (API v2)
    Metadata
    Pagination
    Request IDs
    Connected Accounts
    Versioning
    Enums
Core Resources
    Accountsv2
    Account Linksv2
    Account Tokensv2
    Balances
    Balance Transactions
    Charges
    Customers
    Customer Sessions
    Disputes
    Events
    Eventsv2
    Event Destinationsv2
    Files
    File Links
    Mandates
    Payment Intents
    Personsv2
    Person Tokensv2
    Setup Intents
    Setup Attempts
    Stripe Balance Debit Agreements
    Payouts
    Refunds
    Confirmation Tokens
    Tokens
    Ephemeral Keys
Payment Methods
    Payment Methods
    Payment Method Configurations
    Payment Method Domains
    Bank Accounts
    Cash Balances
    Cash Balance Transactions
    Cards
    Sources
Products
    Products
    Prices
    Coupons
    Promotion Codes
    Discounts
    Tax Codes
    Tax Rates
    Shipping Rates
Product Catalog
    Trial Offers
Commerce
Agentic Commerce
    Shared Payment Issued Tokens
    Shared Payment Granted Tokens
Checkout
    Checkout Sessions
Payment Links
    Payment Links
    The Payment Link objectCreate a payment linkUpdate a payment linkRetrieve payment linkRetrieve a payment link's line itemsList all payment links
Billing
    Alerts
    Credit Balance Summaries
    Credit Balance Transactions
    Credit Grants
    Credit Notes
    Customer Balance Transactions
    Customer Portal Configurations
    Customer Portal Sessions
    Feedback Options
    Invoices
    Invoice Items
    Invoice Line Items
    Invoice Payments
    Invoice Rendering Templates
    Meters
    Meter Events
    Meter Event Adjustment
    Meter Event Adjustmentsv2
    Meter Event Streamsv2
    Meter Event Summary
    Meter Eventsv2
    Plans
    Quotes
    Subscriptions
    Subscription Items
    Subscription Schedules
    Tax IDs
    Test Clocks
Capital
    Financing Offers
    Financing Summaries
Connect
    Accounts
    Login Links
    Account Links
    Account Sessions
    Application Fees
    Application Fee Refunds
    Capabilities
    Country Specs
    Balance Settings
    External Bank Accounts
    External Account Cards
    Persons
    Top-ups
    Transfers
    Transfer Reversals
    Secrets
    App Installs
Reserves
Fraud
Issuing
Terminal
Treasury for Platforms
Payment Records
Account Evaluation
Entitlements
Sigma
Reporting
Financial Connections
Tax
Identity
Crypto
Climate
Forwarding
Privacy
Webhooks
  • 2026-09-30.endive
  • API Reference
  • Docs
  • Support
  • Sign in →

Retrieve a payment link's line items v1

GET /v1/payment_links/:id/line_items

When retrieving a payment link, there is an includable line_items property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.

Parameters

No parameters.

More parameters

  • ending_beforestring

  • limitinteger

  • starting_afterstring

Returns

A dictionary with a data property that contains an array of up to limit payment link line items, starting after Line Item starting_after. Each entry in the array is a separate Line Item object. If no more line items are available, the resulting array will be empty.

curl https://api.stripe.com/v1/payment_links/{{PAYMENT_LINK_ID}}/line_items \
-u "sk_test_BQokikJOvBiI2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:"
Response
{
"object": "list",
"data": [
{
"id": "li_NpsHNiHSaDeU0X",
"object": "item",
"amount_discount": 0,
"amount_subtotal": 1099,
"amount_tax": 0,
"amount_total": 1099,
"currency": "usd",
"description": "T-shirt",
"price": {
"id": "price_1N4AEsLkdIwHu7ix7Ssho8Cl",
"object": "price",
"active": true,
"billing_scheme": "per_unit",
"created": 1683237782,
"currency": "usd",
"custom_unit_amount": null,
"livemode": false,
"lookup_key": null,
"metadata": {},
"nickname": null,
"product": "prod_NppuJWzzNnD5Ut",
"recurring": null,
"tax_behavior": "unspecified",
"tiers_mode": null,
"transform_quantity": null,
"type": "one_time",
"unit_amount": 1099,
"unit_amount_decimal": "1099"
},
"quantity": 1
}
],
"has_more": false,
"url": "/v1/payment_links/plink_1N4CWjLkdIwHu7ix2Y2F1kqb/line_items"
}

List all payment links v1

GET /v1/payment_links

Returns a list of your payment links.

Parameters

  • activeboolean

    Only return payment links that are active or inactive (e.g., pass false to list all inactive payment links).

More parameters

  • ending_beforestring

  • limitinteger

  • starting_afterstring

Returns

A dictionary with a data property that contains an array of up to limit payment links, starting after payment link starting_after. Each entry in the array is a separate payment link object. If no more payment links are available, the resulting array will be empty. This request should never raise an error.

curl -G https://api.stripe.com/v1/payment_links \
-u "sk_test_BQokikJOvBiI2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
-d limit=3
Response
{
"object": "list",
"url": "/v1/payment_links",
"has_more": false,
"data": [
{
"id": "plink_1MoC3ULkdIwHu7ixZjtGpVl2",
"object": "payment_link",
"active": true,
"after_completion": {
"hosted_confirmation": {
"custom_message": null
},
"type": "hosted_confirmation"
},
"allow_promotion_codes": false,
"application_fee_amount": null,
"application_fee_percent": null,
"automatic_tax": {
"enabled": false,
"liability": null
},
"billing_address_collection": "auto",
"consent_collection": null,
"currency": "usd",
"custom_fields": [],
"custom_text": {
"shipping_address": null,
"submit": null
},
"customer_creation": "if_required",
"invoice_creation": {
"enabled": false,
"invoice_data": {
"account_tax_ids": null,
"custom_fields": null,
"description": null,
"footer": null,
"issuer": null,
"metadata": {},
"rendering_options": null
}
},
"livemode": false,
"metadata": {},
"on_behalf_of": null,
"payment_intent_data": null,
"payment_method_collection": "always",
"payment_method_types": null,
"phone_number_collection": {
"enabled": false
},
"shipping_address_collection": null,
"shipping_options": [],
"submit_type": "auto",
"subscription_data": {
"description": null,
"invoice_settings": {
"issuer": {
"type": "self"
}
},
"trial_period_days": null
},
"tax_id_collection": {
"enabled": false
},
"transfer_data": null,
"url": "https://buy.stripe.com/test_cN25nr0iZ7bUa7meUY"
}
]
}
  • Need help? Contact Support.
  • Chat with Stripe developers on Discord.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc