Contacts

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.

get/contacts/{id}/subscriptions

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

idstring uuid required

Customer contact in the selected selling company

Query parameters

view'subscriptions' | 'search' | 'invoices' | 'portal'
integrationIdstring

Company-owned Stripe integration UUID for search

querystring

Customer name/email or Stripe ID, 2–200 characters

pagestring

Opaque search nextPage

cursorstring

Opaque invoice nextCursor

Response

subscriptions, companyName and customerName. Manager responses also include connections; private customer responses never include account choices or Stripe dashboard URLs.

companyNamestring
customerNamestring

Changes

No recorded changes to this operation across all 4 revisions of this API.