Read or find existing company subscriptions
Firm staff with company access can read explicitly linked subscriptions, search firm-owned Stripe accounts, or read linked invoice history. A company may have multiple subscriptions. Each charge retains its actual currency, quantity, interval and variable-price status. A firm accounting connection can be reused without changing its feed. view=search requires integrationId and query; page continues a customer search. view=invoices returns authorized invoice/PDF URLs only after checking every invoice line against this company's links. cursor continues history until nextCursor is null. These subscriptions are independent of onboarding and LedgerHQ's own platform billing.
Request
- Base URL: https://ledgerhq.pro/api/v1
- URL: https://ledgerhq.pro/api/v1/companies/{companyId}/billing/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
LedgerHQ company UUID
Query parameters
Firm-owned integration ID returned in connections; required for search
Customer name, email, cus_ ID or sub_ ID
Opaque search nextPage
Opaque invoice nextCursor
Response
Subscriptions plus firm connections; search results plus nextPage; or invoices plus nextCursor. Amounts are integer cents; variable charges have null amountCents.
Changes
No recorded changes to this operation across all 5 revisions of this API.