Skip to main content
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": 0,
    "updatedAt": 0,
    "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": 0,
      "updatedAt": 0,
      "livemode": true,
      "startDate": 0,
      "customerId": "<string>",
      "organizationId": "<string>",
      "status": "active",
      "defaultPaymentMethodId": "<string>",
      "backupPaymentMethodId": "<string>",
      "trialEnd": null,
      "currentBillingPeriodStart": null,
      "currentBillingPeriodEnd": null,
      "metadata": {},
      "canceledAt": 0,
      "cancelScheduledAt": 0,
      "cancellationReason": "<string>",
      "replacedBySubscriptionId": "<string>",
      "isFreePlan": true,
      "priceId": "<string>",
      "runBillingAtPeriodStart": true,
      "interval": null,
      "intervalCount": null,
      "billingCycleAnchorDate": null,
      "name": "<string>",
      "renews": true,
      "current": true,
      "subscriptionItems": [
        {
          "id": "<string>",
          "createdAt": 0,
          "updatedAt": 0,
          "livemode": true,
          "subscriptionId": "<string>",
          "name": "<string>",
          "addedDate": 0,
          "priceId": "<string>",
          "unitPrice": 4503599627370495,
          "quantity": 4503599627370495,
          "metadata": {},
          "type": "<string>",
          "externalId": "<string>",
          "expiredAt": 0,
          "price": {
            "id": "<string>",
            "createdAt": 0,
            "updatedAt": 0,
            "livemode": true,
            "intervalUnit": "day",
            "name": "<string>",
            "intervalCount": 4503599627370495,
            "type": "<string>",
            "trialPeriodDays": 4503599627370495,
            "isDefault": true,
            "unitPrice": 4503599627370495,
            "usageEventsPerUnit": null,
            "productId": "<string>",
            "active": true,
            "currency": "USD",
            "slug": "<string>",
            "usageMeterId": null
          }
        }
      ],
      "experimental": {
        "featureItems": [
          {
            "id": "<string>",
            "createdAt": 0,
            "updatedAt": 0,
            "livemode": true,
            "subscriptionItemId": "<string>",
            "featureId": "<string>",
            "productFeatureId": "<string>",
            "type": "<string>",
            "amount": null,
            "usageMeterId": null,
            "renewalFrequency": null,
            "expiredAt": 0,
            "detachedAt": 0,
            "detachedReason": "<string>",
            "name": "<string>",
            "slug": "<string>"
          }
        ],
        "usageMeterBalances": [
          {
            "id": "<string>",
            "createdAt": 0,
            "updatedAt": 0,
            "livemode": true,
            "organizationId": "<string>",
            "name": "<string>",
            "pricingModelId": "<string>",
            "slug": "<string>",
            "aggregationType": "sum",
            "availableBalance": 123,
            "subscriptionId": "<string>"
          }
        ]
      }
    }
  ],
  "invoices": [
    {
      "invoice": {
        "id": "<string>",
        "createdAt": 0,
        "updatedAt": 0,
        "livemode": true,
        "purchaseId": "<string>",
        "invoiceNumber": "<string>",
        "invoiceDate": 0,
        "billingPeriodId": null,
        "dueDate": 0,
        "customerId": "<string>",
        "organizationId": "<string>",
        "status": "draft",
        "subscriptionId": null,
        "billingRunId": "<string>",
        "billingPeriodStartDate": null,
        "billingPeriodEndDate": null,
        "ownerMembershipId": "<string>",
        "pdfURL": "<string>",
        "receiptPdfURL": "<string>",
        "memo": "<string>",
        "bankPaymentOnly": true,
        "type": "<string>",
        "currency": "USD",
        "taxAmount": -1,
        "subtotal": -1,
        "taxType": "amusement_tax",
        "taxCountry": "AD",
        "taxState": "<string>",
        "taxRatePercentage": "<string>",
        "applicationFee": -1
      },
      "invoiceLineItems": [
        {
          "id": "<string>",
          "createdAt": 0,
          "updatedAt": 0,
          "livemode": true,
          "invoiceId": "<string>",
          "quantity": -1,
          "priceId": "<string>",
          "description": "<string>",
          "price": -1,
          "type": "<string>",
          "ledgerAccountId": null,
          "ledgerAccountCredit": null
        }
      ]
    }
  ],
  "paymentMethods": [
    {
      "id": "<string>",
      "createdAt": 0,
      "updatedAt": 0,
      "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": 0,
      "updatedAt": 0,
      "livemode": true,
      "name": "<string>",
      "status": "open",
      "customerId": "<string>",
      "organizationId": "<string>",
      "billingCycleAnchor": 0,
      "priceId": "<string>",
      "quantity": 123,
      "priceType": "<string>",
      "trialPeriodDays": 4503599627370495,
      "pricePerBillingCycle": 123,
      "intervalUnit": "day",
      "intervalCount": 123,
      "firstInvoiceValue": 4503599627370495,
      "totalPurchaseValue": null,
      "bankPaymentOnly": true,
      "purchaseDate": 0,
      "endDate": 0,
      "proposal": "<string>",
      "archived": true,
      "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>"
      },
      "metadata": {},
      "position": 123
    }
  ],
  "currentSubscriptions": [
    {
      "id": "<string>",
      "createdAt": 0,
      "updatedAt": 0,
      "livemode": true,
      "startDate": 0,
      "customerId": "<string>",
      "organizationId": "<string>",
      "status": "active",
      "defaultPaymentMethodId": "<string>",
      "backupPaymentMethodId": "<string>",
      "trialEnd": null,
      "currentBillingPeriodStart": null,
      "currentBillingPeriodEnd": null,
      "metadata": {},
      "canceledAt": 0,
      "cancelScheduledAt": 0,
      "cancellationReason": "<string>",
      "replacedBySubscriptionId": "<string>",
      "isFreePlan": true,
      "priceId": "<string>",
      "runBillingAtPeriodStart": true,
      "interval": null,
      "intervalCount": null,
      "billingCycleAnchorDate": null,
      "name": "<string>",
      "renews": true,
      "current": true,
      "subscriptionItems": [
        {
          "id": "<string>",
          "createdAt": 0,
          "updatedAt": 0,
          "livemode": true,
          "subscriptionId": "<string>",
          "name": "<string>",
          "addedDate": 0,
          "priceId": "<string>",
          "unitPrice": 4503599627370495,
          "quantity": 4503599627370495,
          "metadata": {},
          "type": "<string>",
          "externalId": "<string>",
          "expiredAt": 0,
          "price": {
            "id": "<string>",
            "createdAt": 0,
            "updatedAt": 0,
            "livemode": true,
            "intervalUnit": "day",
            "name": "<string>",
            "intervalCount": 4503599627370495,
            "type": "<string>",
            "trialPeriodDays": 4503599627370495,
            "isDefault": true,
            "unitPrice": 4503599627370495,
            "usageEventsPerUnit": null,
            "productId": "<string>",
            "active": true,
            "currency": "USD",
            "slug": "<string>",
            "usageMeterId": null
          }
        }
      ],
      "experimental": {
        "featureItems": [
          {
            "id": "<string>",
            "createdAt": 0,
            "updatedAt": 0,
            "livemode": true,
            "subscriptionItemId": "<string>",
            "featureId": "<string>",
            "productFeatureId": "<string>",
            "type": "<string>",
            "amount": null,
            "usageMeterId": null,
            "renewalFrequency": null,
            "expiredAt": 0,
            "detachedAt": 0,
            "detachedReason": "<string>",
            "name": "<string>",
            "slug": "<string>"
          }
        ],
        "usageMeterBalances": [
          {
            "id": "<string>",
            "createdAt": 0,
            "updatedAt": 0,
            "livemode": true,
            "organizationId": "<string>",
            "name": "<string>",
            "pricingModelId": "<string>",
            "slug": "<string>",
            "aggregationType": "sum",
            "availableBalance": 123,
            "subscriptionId": "<string>"
          }
        ]
      }
    }
  ],
  "currentSubscription": {
    "id": "<string>",
    "createdAt": 0,
    "updatedAt": 0,
    "livemode": true,
    "startDate": 0,
    "customerId": "<string>",
    "organizationId": "<string>",
    "status": "active",
    "defaultPaymentMethodId": "<string>",
    "backupPaymentMethodId": "<string>",
    "trialEnd": null,
    "currentBillingPeriodStart": null,
    "currentBillingPeriodEnd": null,
    "metadata": {},
    "canceledAt": 0,
    "cancelScheduledAt": 0,
    "cancellationReason": "<string>",
    "replacedBySubscriptionId": "<string>",
    "isFreePlan": true,
    "priceId": "<string>",
    "runBillingAtPeriodStart": true,
    "interval": null,
    "intervalCount": null,
    "billingCycleAnchorDate": null,
    "name": "<string>",
    "renews": true,
    "current": true,
    "subscriptionItems": [
      {
        "id": "<string>",
        "createdAt": 0,
        "updatedAt": 0,
        "livemode": true,
        "subscriptionId": "<string>",
        "name": "<string>",
        "addedDate": 0,
        "priceId": "<string>",
        "unitPrice": 4503599627370495,
        "quantity": 4503599627370495,
        "metadata": {},
        "type": "<string>",
        "externalId": "<string>",
        "expiredAt": 0,
        "price": {
          "id": "<string>",
          "createdAt": 0,
          "updatedAt": 0,
          "livemode": true,
          "intervalUnit": "day",
          "name": "<string>",
          "intervalCount": 4503599627370495,
          "type": "<string>",
          "trialPeriodDays": 4503599627370495,
          "isDefault": true,
          "unitPrice": 4503599627370495,
          "usageEventsPerUnit": null,
          "productId": "<string>",
          "active": true,
          "currency": "USD",
          "slug": "<string>",
          "usageMeterId": null
        }
      }
    ],
    "experimental": {
      "featureItems": [
        {
          "id": "<string>",
          "createdAt": 0,
          "updatedAt": 0,
          "livemode": true,
          "subscriptionItemId": "<string>",
          "featureId": "<string>",
          "productFeatureId": "<string>",
          "type": "<string>",
          "amount": null,
          "usageMeterId": null,
          "renewalFrequency": null,
          "expiredAt": 0,
          "detachedAt": 0,
          "detachedReason": "<string>",
          "name": "<string>",
          "slug": "<string>"
        }
      ],
      "usageMeterBalances": [
        {
          "id": "<string>",
          "createdAt": 0,
          "updatedAt": 0,
          "livemode": true,
          "organizationId": "<string>",
          "name": "<string>",
          "pricingModelId": "<string>",
          "slug": "<string>",
          "aggregationType": "sum",
          "availableBalance": 123,
          "subscriptionId": "<string>"
        }
      ]
    }
  },
  "catalog": {
    "id": "<string>",
    "createdAt": 0,
    "updatedAt": 0,
    "livemode": true,
    "organizationId": "<string>",
    "isDefault": true,
    "name": "<string>",
    "integrationGuideHash": "<string>",
    "products": [
      {
        "id": "<string>",
        "createdAt": 0,
        "updatedAt": 0,
        "livemode": true,
        "name": "<string>",
        "description": "<string>",
        "imageURL": "<string>",
        "organizationId": "<string>",
        "active": true,
        "singularQuantityLabel": "<string>",
        "pluralQuantityLabel": "<string>",
        "pricingModelId": "<string>",
        "default": true,
        "slug": "<string>",
        "prices": [
          {
            "id": "<string>",
            "createdAt": 0,
            "updatedAt": 0,
            "livemode": true,
            "intervalUnit": "day",
            "name": "<string>",
            "intervalCount": 4503599627370495,
            "type": "<string>",
            "trialPeriodDays": 4503599627370495,
            "isDefault": true,
            "unitPrice": 4503599627370495,
            "usageEventsPerUnit": null,
            "productId": "<string>",
            "active": true,
            "currency": "USD",
            "slug": "<string>",
            "usageMeterId": null
          }
        ],
        "defaultPrice": {
          "id": "<string>",
          "createdAt": 0,
          "updatedAt": 0,
          "livemode": true,
          "intervalUnit": "day",
          "name": "<string>",
          "intervalCount": 4503599627370495,
          "type": "<string>",
          "trialPeriodDays": 4503599627370495,
          "isDefault": true,
          "unitPrice": 4503599627370495,
          "usageEventsPerUnit": null,
          "productId": "<string>",
          "active": true,
          "currency": "USD",
          "slug": "<string>",
          "usageMeterId": null
        },
        "features": [
          {
            "id": "<string>",
            "createdAt": 0,
            "updatedAt": 0,
            "livemode": true,
            "organizationId": "<string>",
            "type": "<string>",
            "slug": "<string>",
            "name": "<string>",
            "description": "<string>",
            "amount": null,
            "usageMeterId": null,
            "renewalFrequency": null,
            "pricingModelId": "<string>",
            "active": true
          }
        ]
      }
    ],
    "usageMeters": [
      {
        "id": "<string>",
        "createdAt": 0,
        "updatedAt": 0,
        "livemode": true,
        "organizationId": "<string>",
        "name": "<string>",
        "pricingModelId": "<string>",
        "slug": "<string>",
        "aggregationType": "sum"
      }
    ],
    "defaultProduct": {
      "id": "<string>",
      "createdAt": 0,
      "updatedAt": 0,
      "livemode": true,
      "name": "<string>",
      "description": "<string>",
      "imageURL": "<string>",
      "organizationId": "<string>",
      "active": true,
      "singularQuantityLabel": "<string>",
      "pluralQuantityLabel": "<string>",
      "pricingModelId": "<string>",
      "default": true,
      "slug": "<string>",
      "prices": [
        {
          "id": "<string>",
          "createdAt": 0,
          "updatedAt": 0,
          "livemode": true,
          "intervalUnit": "day",
          "name": "<string>",
          "intervalCount": 4503599627370495,
          "type": "<string>",
          "trialPeriodDays": 4503599627370495,
          "isDefault": true,
          "unitPrice": 4503599627370495,
          "usageEventsPerUnit": null,
          "productId": "<string>",
          "active": true,
          "currency": "USD",
          "slug": "<string>",
          "usageMeterId": null
        }
      ],
      "defaultPrice": {
        "id": "<string>",
        "createdAt": 0,
        "updatedAt": 0,
        "livemode": true,
        "intervalUnit": "day",
        "name": "<string>",
        "intervalCount": 4503599627370495,
        "type": "<string>",
        "trialPeriodDays": 4503599627370495,
        "isDefault": true,
        "unitPrice": 4503599627370495,
        "usageEventsPerUnit": null,
        "productId": "<string>",
        "active": true,
        "currency": "USD",
        "slug": "<string>",
        "usageMeterId": null
      },
      "features": [
        {
          "id": "<string>",
          "createdAt": 0,
          "updatedAt": 0,
          "livemode": true,
          "organizationId": "<string>",
          "type": "<string>",
          "slug": "<string>",
          "name": "<string>",
          "description": "<string>",
          "amount": null,
          "usageMeterId": null,
          "renewalFrequency": null,
          "pricingModelId": "<string>",
          "active": true
        }
      ]
    }
  },
  "pricingModel": {
    "id": "<string>",
    "createdAt": 0,
    "updatedAt": 0,
    "livemode": true,
    "organizationId": "<string>",
    "isDefault": true,
    "name": "<string>",
    "integrationGuideHash": "<string>",
    "products": [
      {
        "id": "<string>",
        "createdAt": 0,
        "updatedAt": 0,
        "livemode": true,
        "name": "<string>",
        "description": "<string>",
        "imageURL": "<string>",
        "organizationId": "<string>",
        "active": true,
        "singularQuantityLabel": "<string>",
        "pluralQuantityLabel": "<string>",
        "pricingModelId": "<string>",
        "default": true,
        "slug": "<string>",
        "prices": [
          {
            "id": "<string>",
            "createdAt": 0,
            "updatedAt": 0,
            "livemode": true,
            "intervalUnit": "day",
            "name": "<string>",
            "intervalCount": 4503599627370495,
            "type": "<string>",
            "trialPeriodDays": 4503599627370495,
            "isDefault": true,
            "unitPrice": 4503599627370495,
            "usageEventsPerUnit": null,
            "productId": "<string>",
            "active": true,
            "currency": "USD",
            "slug": "<string>",
            "usageMeterId": null
          }
        ],
        "defaultPrice": {
          "id": "<string>",
          "createdAt": 0,
          "updatedAt": 0,
          "livemode": true,
          "intervalUnit": "day",
          "name": "<string>",
          "intervalCount": 4503599627370495,
          "type": "<string>",
          "trialPeriodDays": 4503599627370495,
          "isDefault": true,
          "unitPrice": 4503599627370495,
          "usageEventsPerUnit": null,
          "productId": "<string>",
          "active": true,
          "currency": "USD",
          "slug": "<string>",
          "usageMeterId": null
        },
        "features": [
          {
            "id": "<string>",
            "createdAt": 0,
            "updatedAt": 0,
            "livemode": true,
            "organizationId": "<string>",
            "type": "<string>",
            "slug": "<string>",
            "name": "<string>",
            "description": "<string>",
            "amount": null,
            "usageMeterId": null,
            "renewalFrequency": null,
            "pricingModelId": "<string>",
            "active": true
          }
        ]
      }
    ],
    "usageMeters": [
      {
        "id": "<string>",
        "createdAt": 0,
        "updatedAt": 0,
        "livemode": true,
        "organizationId": "<string>",
        "name": "<string>",
        "pricingModelId": "<string>",
        "slug": "<string>",
        "aggregationType": "sum"
      }
    ],
    "defaultProduct": {
      "id": "<string>",
      "createdAt": 0,
      "updatedAt": 0,
      "livemode": true,
      "name": "<string>",
      "description": "<string>",
      "imageURL": "<string>",
      "organizationId": "<string>",
      "active": true,
      "singularQuantityLabel": "<string>",
      "pluralQuantityLabel": "<string>",
      "pricingModelId": "<string>",
      "default": true,
      "slug": "<string>",
      "prices": [
        {
          "id": "<string>",
          "createdAt": 0,
          "updatedAt": 0,
          "livemode": true,
          "intervalUnit": "day",
          "name": "<string>",
          "intervalCount": 4503599627370495,
          "type": "<string>",
          "trialPeriodDays": 4503599627370495,
          "isDefault": true,
          "unitPrice": 4503599627370495,
          "usageEventsPerUnit": null,
          "productId": "<string>",
          "active": true,
          "currency": "USD",
          "slug": "<string>",
          "usageMeterId": null
        }
      ],
      "defaultPrice": {
        "id": "<string>",
        "createdAt": 0,
        "updatedAt": 0,
        "livemode": true,
        "intervalUnit": "day",
        "name": "<string>",
        "intervalCount": 4503599627370495,
        "type": "<string>",
        "trialPeriodDays": 4503599627370495,
        "isDefault": true,
        "unitPrice": 4503599627370495,
        "usageEventsPerUnit": null,
        "productId": "<string>",
        "active": true,
        "currency": "USD",
        "slug": "<string>",
        "usageMeterId": null
      },
      "features": [
        {
          "id": "<string>",
          "createdAt": 0,
          "updatedAt": 0,
          "livemode": true,
          "organizationId": "<string>",
          "type": "<string>",
          "slug": "<string>",
          "name": "<string>",
          "description": "<string>",
          "amount": null,
          "usageMeterId": null,
          "renewalFrequency": null,
          "pricingModelId": "<string>",
          "active": true
        }
      ]
    }
  },
  "billingPortalUrl": "<string>"
}

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
  • Option 1
  • Option 2
​
invoices
object[]
required
​
paymentMethods
object[]
required
​
purchases
object[]
required
  • Option 1
  • Option 2
  • Option 3
​
catalog
object
required
​
pricingModel
object
required
​
billingPortalUrl
string<uri>
required

The billing portal URL for the customer

​
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.

  • Option 1
  • Option 2
​
currentSubscription
object

The most recently created current subscription for the customer. If createdAt timestamps tie, the most recently updated subscription will be returned. If updatedAt also ties, subscription id is used as the final tiebreaker.

  • Option 1
  • Option 2