Knowledge Center

Run billing with Floatless.

Product guides, billing concepts, operational playbooks, developer references, and security notes for teams running subscription revenue.

Customers API

Customers are the account records that subscriptions, invoices, payment methods, and portal access attach to.

Endpoints

Method Endpoint Description
GET /customers List customers
POST /customers Create a customer
GET /customers/{customer_id} Retrieve a customer

The Customer object

{
  "id": 123,
  "object": "customer",
  "name": "Acme Corp",
  "contact_name": "Jane Buyer",
  "email": "[email protected]",
  "phone": "+1-555-0123",
  "address_line1": "123 Main St",
  "address_line2": null,
  "city": "San Francisco",
  "state_province": "CA",
  "postal_code": "94105",
  "country": "US",
  "tax_exempt": false,
  "tax_id": null,
  "credit_balance": "0.00000000",
  "auto_pay_enabled": true,
  "created_at": "2026-07-07T10:00:00Z",
  "updated_at": "2026-07-07T10:00:00Z"
}

Create a customer

curl https://api.floatless.com/api/public/v1/customers \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp",
    "email": "[email protected]",
    "contact_name": "Jane Buyer",
    "address_line1": "123 Main St",
    "city": "San Francisco",
    "state_province": "CA",
    "postal_code": "94105",
    "country": "US"
  }'

Parameters

Parameter Type Required Description
name string Yes Customer or company name
email string No Billing email
contact_name string No Primary contact name
phone string No Phone number
address_line1 string No Street address
city string No City
state_province string No State or province
postal_code string No Postal or ZIP code
country string No Two-letter country code, defaults to CA
tax_exempt boolean No Tax exempt status
tax_id string No Tax identification number

List customers

curl https://api.floatless.com/api/public/v1/customers?limit=25&offset=0 \
  -H "Authorization: Bearer sk_live_..."

Query parameters

Parameter Type Description
limit integer Number of results, 1 to 100
offset integer Pagination offset

Retrieve a customer

curl https://api.floatless.com/api/public/v1/customers/123 \
  -H "Authorization: Bearer sk_live_..."

Next steps

PreviousProducts APINextInvoices API