New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates


  • Release Notes

Getting Started


  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee


  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

AI in Chargebee


  • Chargebee Copilot
  • Chargebee Model Context Protocol (MCP) Server

Developer Resources


  • Developer Resources Overview
  • API Explorer
  • Articles and FAQ

Product Catalog


  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions


  • Working with Subscriptions
  • Billing
  • Orders
  • Articles and FAQ

Customers


  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Entitlements


  • Entitlements Overview
  • Features Overview
  • Feature Management
  • Managing Product Entitlements
  • Subscription Entitlements
  • Customer Entitlements
  • Grandfathering Entitlements
  • Articles and FAQ

Usage Based Billing


  • Understanding Usages
  • Setting up Usage Based Billing
  • Usage Alerts
  • Metered Billing
  • Articles and FAQ

Chargebee CPQ


  • Chargebee CPQ
  • Chargebee CPQ for Salesforce
  • Chargebee CPQ for HubSpot

Invoices, Credit Notes, and Quotes


  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes


  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

Hosted Capabilities


  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Pricing Table
  • Managing Payments with Chargebee.js
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration


  • Users & Roles
  • Custom Fields & Metadata
  • Approvals
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Multi Business Entity


  • Multi Business Entity Overview
  • Customer Transfer Overview
  • Articles and FAQ

Mobile Subscriptions


  • Overview
  • Omnichannel Subscriptions
  • Omnichannel One-Time Orders
  • Mobile Subscriptions (Legacy)

Reports and Analytics


  • RevenueStory
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations


  • Sales
  • Customer Support and Success
  • Finance
  • Tax
  • eInvoicing
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Ecommerce Management
  • Articles and FAQ

Data Privacy & Security


  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations


  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  2. Subscriptions
  3. Articles and FAQ
  4. Working with Subscriptions
  1. Billing
  2. Subscriptions
  3. Articles and FAQ
  4. Working with Subscriptions

How to get the recent subscription of each individual customer via API?

Problem Statement

You want to know how to get the recent subscription of each individual customer via api.

Scope

How to get the last subscription of each individual customer via API?

Is there any way to get the recent subscription using API?

What is the parameter to get each customer's subscription by month via API?

Summary

You can make use of the List Subscription API call and use the parameter 'sort_by[ ]' to filter the subscription by period.

Solution

Step 1: You can make use of this API call to list subscriptions.

Step 2: To filter the subscription by period.

sort_by[ ]

optional, string filter Sorts based on the specified attribute. Supported attributes: created_at, updated_at Supported sort-orders: asc, desc

Example → sort_by[asc] = "created_at" This will sort the result based on the 'created_at' attribute in ascending(earliest first) order.

Step 3: To filter the subscription by customer.

id[ ]

optional, string filter A unique and immutable identifier for the subscription. If not provided, it is autogenerated. Supported operators: is, is_not, starts_with, in, not_in

Example → id[is] = "8gsnbYfsMLds"

customer_id[ ]

optional, string filter Identifier of the customer with whom this subscription is associated. Supported operators: is, is_not, starts_with, in, not_in

Example → customer_id[is_not] = "8gsnbYfsMLds"

Step 4: To filter the subscription by Plan.

item_id[ ]

optional, string filter The plan item code. Supported operators: is, is_not, starts_with, in, not_in

Example → item_id[is] = "silver"

item_price_id[ ]

optional, string filter The plan item price code. Supported operators : is, is_not, starts_with, in, not_in

Example → item_price_id[is] = "silver-USD-monthly"

Step 5: To filter the subscription by subscription status.

status[ ]

optional, enumerated string filter The current state of the subscription. Possible values are: future, in_trial, active, non_renewing, paused, cancelled. Supported operators: is, is_not, in, not_in

Example → status[is] = "active"

Was this article helpful?