GET
/
api
/
v1
/
customers
/
{externalId}
/
billing
Get Billing Details
curl --request GET \
  --url https://app.flowglad.com/api/v1/customers/{externalId}/billing \
  --header 'Authorization: <api-key>'
{
  "customer": {
    "id": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "createdByCommit": "<string>",
    "updatedByCommit": "<string>",
    "livemode": true,
    "organizationId": "<string>",
    "email": "<string>",
    "name": "<string>",
    "invoiceNumberBase": "<string>",
    "archived": true,
    "logoURL": "<string>",
    "iconURL": "<string>",
    "domain": "<string>",
    "billingAddress": {
      "name": "<string>",
      "firstName": "<string>",
      "lastName": "<string>",
      "email": "jsmith@example.com",
      "address": {
        "name": "<string>",
        "line1": "<string>",
        "line2": "<string>",
        "city": "<string>",
        "state": "<string>",
        "postal_code": "<string>",
        "country": "<string>"
      },
      "phone": "<string>"
    },
    "externalId": "<string>",
    "userId": "<string>",
    "pricingModelId": "<string>"
  },
  "subscriptions": [
    {
      "id": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "createdByCommit": "<string>",
      "updatedByCommit": "<string>",
      "livemode": true,
      "startDate": "<string>",
      "customerId": "<string>",
      "organizationId": "<string>",
      "status": "active",
      "defaultPaymentMethodId": "<string>",
      "backupPaymentMethodId": "<string>",
      "trialEnd": "<any>",
      "currentBillingPeriodStart": "<any>",
      "currentBillingPeriodEnd": "<any>",
      "metadata": {},
      "canceledAt": "<string>",
      "cancelScheduledAt": "<string>",
      "cancellationReason": "<string>",
      "replacedBySubscriptionId": "<string>",
      "isFreePlan": true,
      "priceId": "<string>",
      "runBillingAtPeriodStart": true,
      "interval": "<any>",
      "intervalCount": "<any>",
      "billingCycleAnchorDate": "<any>",
      "name": "<string>",
      "renews": true,
      "current": true,
      "subscriptionItems": [
        {
          "id": "<string>",
          "createdAt": "<string>",
          "updatedAt": "<string>",
          "createdByCommit": "<string>",
          "updatedByCommit": "<string>",
          "livemode": true,
          "subscriptionId": "<string>",
          "name": "<string>",
          "addedDate": "<string>",
          "priceId": "<string>",
          "unitPrice": "<any>",
          "quantity": "<any>",
          "usageEventsPerUnit": "<any>",
          "usageMeterId": "<string>",
          "metadata": {},
          "type": "<string>",
          "externalId": "<string>",
          "expiredAt": "<string>",
          "price": {
            "id": "<string>",
            "createdAt": "<string>",
            "updatedAt": "<string>",
            "createdByCommit": "<string>",
            "updatedByCommit": "<string>",
            "livemode": true,
            "intervalUnit": "day",
            "name": "<string>",
            "intervalCount": "<any>",
            "type": "<string>",
            "trialPeriodDays": "<any>",
            "setupFeeAmount": "<any>",
            "isDefault": true,
            "unitPrice": "<any>",
            "usageEventsPerUnit": "<any>",
            "productId": "<string>",
            "active": true,
            "currency": "USD",
            "startsWithCreditTrial": "<any>",
            "slug": "<string>",
            "overagePriceId": "<any>",
            "usageMeterId": "<any>"
          }
        }
      ],
      "experimental": {
        "featureItems": [
          {
            "id": "<string>",
            "createdAt": "<string>",
            "updatedAt": "<string>",
            "createdByCommit": "<string>",
            "updatedByCommit": "<string>",
            "livemode": true,
            "subscriptionItemId": "<string>",
            "featureId": "<string>",
            "productFeatureId": "<string>",
            "type": "<string>",
            "amount": null,
            "usageMeterId": null,
            "renewalFrequency": null,
            "expiredAt": "<string>",
            "detachedAt": "<string>",
            "detachedReason": "<string>",
            "name": "<string>",
            "slug": "<string>"
          }
        ],
        "usageMeterBalances": [
          {
            "id": "<string>",
            "createdAt": "<string>",
            "updatedAt": "<string>",
            "createdByCommit": "<string>",
            "updatedByCommit": "<string>",
            "livemode": true,
            "organizationId": "<string>",
            "name": "<string>",
            "pricingModelId": "<string>",
            "slug": "<string>",
            "aggregationType": "sum",
            "availableBalance": 123,
            "subscriptionId": "<string>"
          }
        ]
      }
    }
  ],
  "invoices": [
    {
      "invoice": {
        "id": "<string>",
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "createdByCommit": "<string>",
        "updatedByCommit": "<string>",
        "livemode": true,
        "purchaseId": "<string>",
        "invoiceNumber": "<string>",
        "invoiceDate": "<string>",
        "billingPeriodId": "<any>",
        "dueDate": "<string>",
        "customerId": "<string>",
        "organizationId": "<string>",
        "status": "draft",
        "subscriptionId": "<any>",
        "billingRunId": "<string>",
        "billingPeriodStartDate": "<any>",
        "billingPeriodEndDate": "<any>",
        "ownerMembershipId": "<string>",
        "pdfURL": "<string>",
        "receiptPdfURL": "<string>",
        "memo": "<string>",
        "bankPaymentOnly": true,
        "type": "<string>",
        "currency": "USD",
        "taxAmount": -1,
        "subtotal": -1,
        "taxType": "amusement_tax",
        "taxCountry": "AF",
        "taxState": "<string>",
        "taxRatePercentage": "<string>",
        "applicationFee": -1
      },
      "invoiceLineItems": [
        {
          "id": "<string>",
          "createdAt": "<string>",
          "updatedAt": "<string>",
          "createdByCommit": "<string>",
          "updatedByCommit": "<string>",
          "livemode": true,
          "invoiceId": "<string>",
          "quantity": "<any>",
          "priceId": "<string>",
          "description": "<string>",
          "price": -1,
          "type": "<string>"
        }
      ]
    }
  ],
  "paymentMethods": [
    {
      "id": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "createdByCommit": "<string>",
      "updatedByCommit": "<string>",
      "livemode": true,
      "customerId": "<string>",
      "billingDetails": {
        "name": "<string>",
        "email": "<string>",
        "address": {
          "name": "<string>",
          "line1": "<string>",
          "line2": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postal_code": "<string>",
          "country": "<string>",
          "address": {
            "name": "<string>",
            "line1": "<string>",
            "line2": "<string>",
            "city": "<string>",
            "state": "<string>",
            "postal_code": "<string>",
            "country": "<string>"
          }
        }
      },
      "type": "card",
      "default": true,
      "paymentMethodData": {},
      "metadata": {}
    }
  ],
  "purchases": [
    {
      "id": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "createdByCommit": "<string>",
      "updatedByCommit": "<string>",
      "livemode": true,
      "name": "<string>",
      "status": "open",
      "customerId": "<string>",
      "organizationId": "<string>",
      "billingCycleAnchor": "<string>",
      "priceId": "<string>",
      "quantity": "<any>",
      "priceType": "<string>",
      "trialPeriodDays": "<any>",
      "pricePerBillingCycle": "<any>",
      "intervalUnit": "day",
      "intervalCount": "<any>",
      "firstInvoiceValue": "<any>",
      "totalPurchaseValue": "<any>",
      "bankPaymentOnly": true,
      "purchaseDate": "<string>",
      "endDate": "<string>",
      "proposal": "<string>",
      "archived": true,
      "billingAddress": "<string>",
      "metadata": {}
    }
  ],
  "currentSubscriptions": [
    {
      "id": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "createdByCommit": "<string>",
      "updatedByCommit": "<string>",
      "livemode": true,
      "startDate": "<string>",
      "customerId": "<string>",
      "organizationId": "<string>",
      "status": "active",
      "defaultPaymentMethodId": "<string>",
      "backupPaymentMethodId": "<string>",
      "trialEnd": "<any>",
      "currentBillingPeriodStart": "<any>",
      "currentBillingPeriodEnd": "<any>",
      "metadata": {},
      "canceledAt": "<string>",
      "cancelScheduledAt": "<string>",
      "cancellationReason": "<string>",
      "replacedBySubscriptionId": "<string>",
      "isFreePlan": true,
      "priceId": "<string>",
      "runBillingAtPeriodStart": true,
      "interval": "<any>",
      "intervalCount": "<any>",
      "billingCycleAnchorDate": "<any>",
      "name": "<string>",
      "renews": true,
      "current": true,
      "subscriptionItems": [
        {
          "id": "<string>",
          "createdAt": "<string>",
          "updatedAt": "<string>",
          "createdByCommit": "<string>",
          "updatedByCommit": "<string>",
          "livemode": true,
          "subscriptionId": "<string>",
          "name": "<string>",
          "addedDate": "<string>",
          "priceId": "<string>",
          "unitPrice": "<any>",
          "quantity": "<any>",
          "usageEventsPerUnit": "<any>",
          "usageMeterId": "<string>",
          "metadata": {},
          "type": "<string>",
          "externalId": "<string>",
          "expiredAt": "<string>",
          "price": {
            "id": "<string>",
            "createdAt": "<string>",
            "updatedAt": "<string>",
            "createdByCommit": "<string>",
            "updatedByCommit": "<string>",
            "livemode": true,
            "intervalUnit": "day",
            "name": "<string>",
            "intervalCount": "<any>",
            "type": "<string>",
            "trialPeriodDays": "<any>",
            "setupFeeAmount": "<any>",
            "isDefault": true,
            "unitPrice": "<any>",
            "usageEventsPerUnit": "<any>",
            "productId": "<string>",
            "active": true,
            "currency": "USD",
            "startsWithCreditTrial": "<any>",
            "slug": "<string>",
            "overagePriceId": "<any>",
            "usageMeterId": "<any>"
          }
        }
      ],
      "experimental": {
        "featureItems": [
          {
            "id": "<string>",
            "createdAt": "<string>",
            "updatedAt": "<string>",
            "createdByCommit": "<string>",
            "updatedByCommit": "<string>",
            "livemode": true,
            "subscriptionItemId": "<string>",
            "featureId": "<string>",
            "productFeatureId": "<string>",
            "type": "<string>",
            "amount": null,
            "usageMeterId": null,
            "renewalFrequency": null,
            "expiredAt": "<string>",
            "detachedAt": "<string>",
            "detachedReason": "<string>",
            "name": "<string>",
            "slug": "<string>"
          }
        ],
        "usageMeterBalances": [
          {
            "id": "<string>",
            "createdAt": "<string>",
            "updatedAt": "<string>",
            "createdByCommit": "<string>",
            "updatedByCommit": "<string>",
            "livemode": true,
            "organizationId": "<string>",
            "name": "<string>",
            "pricingModelId": "<string>",
            "slug": "<string>",
            "aggregationType": "sum",
            "availableBalance": 123,
            "subscriptionId": "<string>"
          }
        ]
      }
    }
  ],
  "catalog": {
    "id": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "createdByCommit": "<string>",
    "updatedByCommit": "<string>",
    "livemode": true,
    "organizationId": "<string>",
    "isDefault": true,
    "name": "<string>",
    "products": [
      {
        "id": "<string>",
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "createdByCommit": "<string>",
        "updatedByCommit": "<string>",
        "livemode": true,
        "name": "<string>",
        "description": "<string>",
        "imageURL": "<string>",
        "organizationId": "<string>",
        "displayFeatures": [
          {
            "enabled": true,
            "label": "<string>",
            "details": "<string>"
          }
        ],
        "active": true,
        "singularQuantityLabel": "<string>",
        "pluralQuantityLabel": "<string>",
        "pricingModelId": "<string>",
        "default": true,
        "slug": "<string>",
        "prices": [
          {
            "id": "<string>",
            "createdAt": "<string>",
            "updatedAt": "<string>",
            "createdByCommit": "<string>",
            "updatedByCommit": "<string>",
            "livemode": true,
            "intervalUnit": "day",
            "name": "<string>",
            "intervalCount": "<any>",
            "type": "<string>",
            "trialPeriodDays": "<any>",
            "setupFeeAmount": "<any>",
            "isDefault": true,
            "unitPrice": "<any>",
            "usageEventsPerUnit": "<any>",
            "productId": "<string>",
            "active": true,
            "currency": "USD",
            "startsWithCreditTrial": "<any>",
            "slug": "<string>",
            "overagePriceId": "<any>",
            "usageMeterId": "<any>"
          }
        ],
        "defaultPrice": {
          "id": "<string>",
          "createdAt": "<string>",
          "updatedAt": "<string>",
          "createdByCommit": "<string>",
          "updatedByCommit": "<string>",
          "livemode": true,
          "intervalUnit": "day",
          "name": "<string>",
          "intervalCount": "<any>",
          "type": "<string>",
          "trialPeriodDays": "<any>",
          "setupFeeAmount": "<any>",
          "isDefault": true,
          "unitPrice": "<any>",
          "usageEventsPerUnit": "<any>",
          "productId": "<string>",
          "active": true,
          "currency": "USD",
          "startsWithCreditTrial": "<any>",
          "slug": "<string>",
          "overagePriceId": "<any>",
          "usageMeterId": "<any>"
        }
      }
    ],
    "usageMeters": [
      {
        "id": "<string>",
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "createdByCommit": "<string>",
        "updatedByCommit": "<string>",
        "livemode": true,
        "organizationId": "<string>",
        "name": "<string>",
        "pricingModelId": "<string>",
        "slug": "<string>",
        "aggregationType": "sum"
      }
    ],
    "defaultProduct": {
      "id": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "createdByCommit": "<string>",
      "updatedByCommit": "<string>",
      "livemode": true,
      "name": "<string>",
      "description": "<string>",
      "imageURL": "<string>",
      "organizationId": "<string>",
      "displayFeatures": [
        {
          "enabled": true,
          "label": "<string>",
          "details": "<string>"
        }
      ],
      "active": true,
      "singularQuantityLabel": "<string>",
      "pluralQuantityLabel": "<string>",
      "pricingModelId": "<string>",
      "default": true,
      "slug": "<string>",
      "prices": [
        {
          "id": "<string>",
          "createdAt": "<string>",
          "updatedAt": "<string>",
          "createdByCommit": "<string>",
          "updatedByCommit": "<string>",
          "livemode": true,
          "intervalUnit": "day",
          "name": "<string>",
          "intervalCount": "<any>",
          "type": "<string>",
          "trialPeriodDays": "<any>",
          "setupFeeAmount": "<any>",
          "isDefault": true,
          "unitPrice": "<any>",
          "usageEventsPerUnit": "<any>",
          "productId": "<string>",
          "active": true,
          "currency": "USD",
          "startsWithCreditTrial": "<any>",
          "slug": "<string>",
          "overagePriceId": "<any>",
          "usageMeterId": "<any>"
        }
      ],
      "defaultPrice": {
        "id": "<string>",
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "createdByCommit": "<string>",
        "updatedByCommit": "<string>",
        "livemode": true,
        "intervalUnit": "day",
        "name": "<string>",
        "intervalCount": "<any>",
        "type": "<string>",
        "trialPeriodDays": "<any>",
        "setupFeeAmount": "<any>",
        "isDefault": true,
        "unitPrice": "<any>",
        "usageEventsPerUnit": "<any>",
        "productId": "<string>",
        "active": true,
        "currency": "USD",
        "startsWithCreditTrial": "<any>",
        "slug": "<string>",
        "overagePriceId": "<any>",
        "usageMeterId": "<any>"
      }
    }
  },
  "pricingModel": {
    "id": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "createdByCommit": "<string>",
    "updatedByCommit": "<string>",
    "livemode": true,
    "organizationId": "<string>",
    "isDefault": true,
    "name": "<string>",
    "products": [
      {
        "id": "<string>",
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "createdByCommit": "<string>",
        "updatedByCommit": "<string>",
        "livemode": true,
        "name": "<string>",
        "description": "<string>",
        "imageURL": "<string>",
        "organizationId": "<string>",
        "displayFeatures": [
          {
            "enabled": true,
            "label": "<string>",
            "details": "<string>"
          }
        ],
        "active": true,
        "singularQuantityLabel": "<string>",
        "pluralQuantityLabel": "<string>",
        "pricingModelId": "<string>",
        "default": true,
        "slug": "<string>",
        "prices": [
          {
            "id": "<string>",
            "createdAt": "<string>",
            "updatedAt": "<string>",
            "createdByCommit": "<string>",
            "updatedByCommit": "<string>",
            "livemode": true,
            "intervalUnit": "day",
            "name": "<string>",
            "intervalCount": "<any>",
            "type": "<string>",
            "trialPeriodDays": "<any>",
            "setupFeeAmount": "<any>",
            "isDefault": true,
            "unitPrice": "<any>",
            "usageEventsPerUnit": "<any>",
            "productId": "<string>",
            "active": true,
            "currency": "USD",
            "startsWithCreditTrial": "<any>",
            "slug": "<string>",
            "overagePriceId": "<any>",
            "usageMeterId": "<any>"
          }
        ],
        "defaultPrice": {
          "id": "<string>",
          "createdAt": "<string>",
          "updatedAt": "<string>",
          "createdByCommit": "<string>",
          "updatedByCommit": "<string>",
          "livemode": true,
          "intervalUnit": "day",
          "name": "<string>",
          "intervalCount": "<any>",
          "type": "<string>",
          "trialPeriodDays": "<any>",
          "setupFeeAmount": "<any>",
          "isDefault": true,
          "unitPrice": "<any>",
          "usageEventsPerUnit": "<any>",
          "productId": "<string>",
          "active": true,
          "currency": "USD",
          "startsWithCreditTrial": "<any>",
          "slug": "<string>",
          "overagePriceId": "<any>",
          "usageMeterId": "<any>"
        }
      }
    ],
    "usageMeters": [
      {
        "id": "<string>",
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "createdByCommit": "<string>",
        "updatedByCommit": "<string>",
        "livemode": true,
        "organizationId": "<string>",
        "name": "<string>",
        "pricingModelId": "<string>",
        "slug": "<string>",
        "aggregationType": "sum"
      }
    ],
    "defaultProduct": {
      "id": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "createdByCommit": "<string>",
      "updatedByCommit": "<string>",
      "livemode": true,
      "name": "<string>",
      "description": "<string>",
      "imageURL": "<string>",
      "organizationId": "<string>",
      "displayFeatures": [
        {
          "enabled": true,
          "label": "<string>",
          "details": "<string>"
        }
      ],
      "active": true,
      "singularQuantityLabel": "<string>",
      "pluralQuantityLabel": "<string>",
      "pricingModelId": "<string>",
      "default": true,
      "slug": "<string>",
      "prices": [
        {
          "id": "<string>",
          "createdAt": "<string>",
          "updatedAt": "<string>",
          "createdByCommit": "<string>",
          "updatedByCommit": "<string>",
          "livemode": true,
          "intervalUnit": "day",
          "name": "<string>",
          "intervalCount": "<any>",
          "type": "<string>",
          "trialPeriodDays": "<any>",
          "setupFeeAmount": "<any>",
          "isDefault": true,
          "unitPrice": "<any>",
          "usageEventsPerUnit": "<any>",
          "productId": "<string>",
          "active": true,
          "currency": "USD",
          "startsWithCreditTrial": "<any>",
          "slug": "<string>",
          "overagePriceId": "<any>",
          "usageMeterId": "<any>"
        }
      ],
      "defaultPrice": {
        "id": "<string>",
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "createdByCommit": "<string>",
        "updatedByCommit": "<string>",
        "livemode": true,
        "intervalUnit": "day",
        "name": "<string>",
        "intervalCount": "<any>",
        "type": "<string>",
        "trialPeriodDays": "<any>",
        "setupFeeAmount": "<any>",
        "isDefault": true,
        "unitPrice": "<any>",
        "usageEventsPerUnit": "<any>",
        "productId": "<string>",
        "active": true,
        "currency": "USD",
        "startsWithCreditTrial": "<any>",
        "slug": "<string>",
        "overagePriceId": "<any>",
        "usageMeterId": "<any>"
      }
    }
  }
}

Authorizations

Authorization
string
header
required

Path Parameters

externalId
string
required

The ID of the customer, as defined in your application

Response

Successful response

customer
object
required
subscriptions
object[]
required
invoices
object[]
required
paymentMethods
object[]
required
purchases
object[]
required
catalog
object
required
pricingModel
object
required
currentSubscriptions
object[]

The current subscriptions for the customer. By default, customers can only have one active subscription at a time. This will only return multiple subscriptions if you have enabled multiple subscriptions per customer.