Read a customer's subscriptions or find existing Stripe subscriptions
Requires the existing manage:contacts permission and a live customer in the selected company. Uses only that company's Stripe account, never its accountant's account. view=search requires integrationId and query (name/email, cus_ ID, or sub_ ID); returns results (id, customer, subscription, linked) and nextPage. view=portal returns the current private portal link and expiry, or null. view=invoices returns invoices (id, number, subscriptionName, createdAt, amountCents, currency, status, invoiceUrl, pdfUrl) and nextCursor. Amounts are integer minor units (US cents). The full invoice is excluded when any line belongs to another billing recipient. Continue with cursor until nextCursor is null.
Request
- Base URL: https://ledgerhq.pro/api/v1
- URL: https://ledgerhq.pro/api/v1/contacts/{id}/subscriptions
- Auth: one of:
- HTTP bearer and API key in header x-organization-id
- HTTP bearer and API key in header x-organization-id
Path parameters
Customer contact in the selected selling company
Query parameters
Company-owned Stripe integration UUID for search
Customer name/email or Stripe ID, 2–200 characters
Opaque search nextPage
Opaque invoice nextCursor
Response
subscriptions, companyName and customerName. Manager responses also include connections; private customer responses never include account choices or Stripe dashboard URLs.
Changes
No recorded changes to this operation across all 4 revisions of this API.