UseePay Open API
UseePay Portal
Product Docs
  • V2.0
  • V1.0
Mechant Dashboard
UseePay Portal
Product Docs
  • V2.0
  • V1.0
Mechant Dashboard
  1. Subscriptions
  • Intergration
    • About Payment Methods
      • Card
      • Apple Pay
      • Google Pay
      • Klarna
      • Naver pay
      • Kakao Pay
      • Toss Pay
      • Payco
      • Affirm
    • subscription
      • Get started with Subscription
    • online payment
      • Get started with online payments
    • Payment Capabilities
      • Adaptive Price
  • developer
    • Introduction
    • Authentication
    • Errors
    • error code
      • last_payment_error documentation
    • Best Integration
      • Quickly create a paymentIntent for a subscription
      • Auto-Charge Subscription Guide
    • Payment Intents
      • Payment Intent Overview
      • Quickly create a paymentIntent
      • Create a PaymentIntent
      • Retrieve a PaymentIntent
      • Update a PaymentIntent
      • Confirm a PaymentIntent
      • Cancel a PaymentIntent
      • Capture a PaymentIntent
      • List all payment intents
    • Customers
      • Create a customer
      • Retrieves a customer
      • Update a customer
      • List all customers
    • Subscriptions
      • Create a subscription
        POST
      • Retrieves a subscription
        GET
      • Update a subscription
        POST
      • List all subscriptions
        GET
      • Cancel a subscription
        POST
    • Invoices
      • Create a invoice
      • Retrieves a invoice
      • List all invoices
      • Pay a invoice
    • Payment Methods
      • Create a payment method
      • Retrieves a payment method
      • Update a payment method
      • List all payment methods
    • Mandates
      • Create a mandate
      • Retrieves a mandate
      • List all mandates
    • Refunds
      • Create a refund
      • Retrieves a refund
      • List all refunds
    • Webhooks
      • Webhook events
      • Webhook Activation/Signature Verification Steps
      • Create a webhook
      • Retrieves a webhook
      • Update a webhook
      • List all webhooks
    • Embedded Checkout
      • Payment Elements
    • case
    • objects
    • About Testing
      • Test Cards
      • ApplePay&GooglePay
  • message
    • Messaging Element
  • FAQ
    • Unable to receive Webhook notifications
  1. Subscriptions

List all subscriptions

Useepay API V2.0 Sandbox Environment
https://openapi1.uat.useepay.com
Useepay API V2.0 Sandbox Environment
https://openapi1.uat.useepay.com
GET
/api/v1/subscriptions

Request

Query Params

Header Params

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://openapi1.uat.useepay.com/api/v1/subscriptions?page_num=0&page_size=3&from_created_at=2024-09-29T07:44:50.774Z&customer_id=cus_1JA7UDDQG3800&status=canceled' \
--header 'x-merchant-no: 500000000007245' \
--header 'x-api-key: FUYTIUvjhgfytfuytwiue' \
--header 'x-app-id: www.pay.com'
Response Response Example
{
    "items": [
        {
            "id": "sub_1JBPC9HT80000",
            "recurring": {
                "interval": "month",
                "interval_count": 1,
                "unit_amount": 112,
                "total_billing_cycles": 10
            },
            "currency": "USD",
            "description": "subscription desc",
            "order": {
                "category": "Apparel and accessories",
                "products": [
                    {
                        "category": "Apparel and accessories",
                        "code": "3414314111",
                        "desc": "IPHONE 7",
                        "effective_end_at": "2020-12-31T23:59:59Z",
                        "effective_start_at": "2020-01-01T00:00:00Z",
                        "name": "IPHONE7",
                        "quantity": 5,
                        "seller": {
                            "identifier": "string",
                            "name": "string"
                        },
                        "sku": "100004",
                        "type": "physical",
                        "unit_price": 100.01,
                        "url": "https://example.useepay.com/product/12345"
                    }
                ],
                "shipping": {
                    "address": {
                        "city": "Shanghai",
                        "country_code": "CN",
                        "postcode": "100000",
                        "state": "Shanghai",
                        "line1": "Pudong District"
                    },
                    "first_name": "John",
                    "last_name": "Doe",
                    "phone_number": "13800000000",
                    "shipping_method": "sameday"
                }
            },
            "metadata": {
                "sid": "0001"
            },
            "status": "incomplete",
            "livemode": null,
            "prorate": null,
            "merchant_no": "500000000007264",
            "app_id": "www.pay.com",
            "create_at": "2024-10-28T03:49:28Z",
            "modify_at": "2024-10-28T03:49:28Z",
            "customer_id": "cus_1JA7UDDQG3800",
            "cancel_at_period_end": null,
            "current_period_end": null,
            "current_period_start": null,
            "latest_invoice": null,
            "first_invoice_id": null,
            "cancel_at": null,
            "canceled_at": null,
            "collection_method": "charge_automatically",
            "days_until_due": null,
            "ended_at": null,
            "cancellation_details": null,
            "invoice_now": null
        },
        {
            "id": "sub_1JBQGL23O0000",
            "recurring": {
                "interval": "month",
                "interval_count": 1,
                "unit_amount": 112,
                "total_billing_cycles": 10
            },
            "currency": "USD",
            "description": "subscription desc",
            "order": {
                "category": "Apparel and accessories",
                "products": [
                    {
                        "category": "Apparel and accessories",
                        "code": "3414314111",
                        "desc": "IPHONE 7",
                        "effective_end_at": "2020-12-31T23:59:59Z",
                        "effective_start_at": "2020-01-01T00:00:00Z",
                        "name": "IPHONE7",
                        "quantity": 5,
                        "seller": {
                            "identifier": "string",
                            "name": "string"
                        },
                        "sku": "100004",
                        "type": "physical",
                        "unit_price": 100.01,
                        "url": "https://example.useepay.com/product/12345"
                    }
                ],
                "shipping": {
                    "address": {
                        "city": "Shanghai",
                        "country_code": "CN",
                        "postcode": "100000",
                        "state": "Shanghai",
                        "line1": "Pudong District"
                    },
                    "first_name": "John",
                    "last_name": "Doe",
                    "phone_number": "13800000000",
                    "shipping_method": "sameday"
                }
            },
            "metadata": {
                "sid": "0001"
            },
            "status": "incomplete",
            "livemode": null,
            "prorate": null,
            "merchant_no": "500000000007264",
            "app_id": "www.pay.com",
            "create_at": "2024-10-28T06:28:19Z",
            "modify_at": "2024-10-28T06:28:19Z",
            "customer_id": "cus_1JA7UDDQG3800",
            "cancel_at_period_end": null,
            "current_period_end": null,
            "current_period_start": null,
            "latest_invoice": null,
            "first_invoice_id": null,
            "cancel_at": null,
            "canceled_at": null,
            "collection_method": "charge_automatically",
            "days_until_due": null,
            "ended_at": null,
            "cancellation_details": null,
            "invoice_now": null
        }
    ],
    "has_more": false
}
Modified at 2024-12-27 06:00:27
Previous
Update a subscription
Next
Cancel a subscription
Built with