# How can I get the next billing date for a subscription?

**URL:** <https://developer.squareup.com/forums/t/how-can-i-get-the-next-billing-date-for-a-subscription/27990>\
**Category:** Questions\
**Tags:** subscriptions-api\
**Created:** [September 25, 2026, 7:49am UTC](https://developer.squareup.com/forums/t/how-can-i-get-the-next-billing-date-for-a-subscription/27990 "2026-09-25T07:49:00Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![fukuda](https://avatars.discourse-cdn.com/v4/letter/f/e56c9b/32.png) [@fukuda](https://developer.squareup.com/forums/u/fukuda)\
**Post date:** [September 25, 2026, 7:49am UTC](https://developer.squareup.com/forums/t/how-can-i-get-the-next-billing-date-for-a-subscription/27990/1 "2026-09-25T07:49:00Z")

</div>

I want to know how to get the next credit card billing date using the [Square Subscription API](https://developer.squareup.com/explorer/square/subscriptions-api/retrieve-subscription).

According to the following forum post, `charged_through_date` can be used:

> [@How to get next billing date of subscription?](https://developer.squareup.com/forums/t/how-to-get-next-billing-date-of-subscription/6784/2):
>
> Hi @devropes! wave You can determine the next billing date using the charged\_through\_date property, which is the last day of the current billing period. You’ll want to check if the object also has canceled\_date set though, to check if a subscription is being canceled after the current billing period.

Could you clarify which of the following is correct?

- `charged_through_date` is one day before the payment date.
- `charged_through_date` is the payment date.

Additionally, what timezone applies to `charged_through_date`?

---

<div class="post-metadata">

**Author:** ![jseok](https://avatars.discourse-cdn.com/v4/letter/j/f475e1/32.png) [@jseok](https://developer.squareup.com/forums/u/jseok)\
**Post date:** [September 25, 2026, 1:49pm UTC](https://developer.squareup.com/forums/t/how-can-i-get-the-next-billing-date-for-a-subscription/27990/3 "2026-09-25T13:49:28Z")

</div>

The first one is correct. `charged_through_date` is the last day of the period that has already been billed, so the next billing date is the day after it. For example, a monthly subscription invoiced on May 1 has a `charged_through_date` of May 31, and it bills again on June 1. If the subscription has a `canceled_date`, it stops at the end of the current period and there is no next billing date.

`charged_through_date` is a date with no time, in `YYYY-MM-DD` format. It is read in the subscription’s `timezone` field, which is an IANA name such as `America/Los_Angeles` and defaults to the seller location’s timezone. Don’t convert it to UTC. Treat it as a local calendar date in that timezone.

Reference: [Subscription Object - Square API Reference](https://developer.squareup.com/reference/square/objects/Subscription)

---

<div class="post-metadata">

**Author:** ![fukuda](https://avatars.discourse-cdn.com/v4/letter/f/e56c9b/32.png) [@fukuda](https://developer.squareup.com/forums/u/fukuda)\
**Post date:** [September 29, 2026, 10:19am UTC](https://developer.squareup.com/forums/t/how-can-i-get-the-next-billing-date-for-a-subscription/27990/4 "2026-09-29T10:19:38Z")

</div>

Thank you for your answer.

I checked this again, and it seems that `charged_through_date` is the same as the `Next billing` date shown on the Dashboard.  
Could you tell me why?

For example:

```json
{
  "subscription": {
    ...
    "charged_through_date": "2026-10-21",
    ...
    "timezone": "Asia/Tokyo",
    ...
  }
}

```

 ![screen-shot](https://global.discourse-cdn.com/square/original/2X/2/29950872ef56e89c65f74dfbedd59f0b748ef67a.png)