Skip to main content

Customer object

This object represents a customer of your business.
It lets you create a customer, but also track usage and create invoices for the same customer.

Schema

{
"customer": {
"lago_id": "99a6094e-199b-4101-896a-54e927ce7bd7",
"sequential_id": "001",
"slug": "LAG-1234-001",
"external_id": "5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba",
"address_line1": "5230 Penfield Ave",
"address_line2": null,
"city": "Woodland Hills",
"country": "US",
"created_at": "2022-04-29T08:59:51Z",
"email": "dinesh@piedpiper.test",
"legal_name": "Coleman-Blair",
"legal_number": "49-008-2965",
"logo_url": "http://hooli.com/logo.png",
"name": "Gavin Belson",
"phone": "1-171-883-3711 x245",
"state": "CA",
"url": "http://hooli.com",
"vat_rate": 12.5,
"zipcode": "91364",
"billing_configuration": {
"payment_provider": "stripe",
"provider_customer_id": "cus_12345"
}
}
}
AttributesDescription
lago_id     String     Not nullableUnique identifer of the customer in Lago application
sequential_id     String     Not nullableSequential id of the customer scoped on the organization
slug     String     Not nullableSlug of the customer based on the Organization name, id and customer sequantial_id
external_id     String     Not nullableUnique identifer of the customer in your application
address_line1     StringFirst line of the billing address
address_line2     StringSecond line of the billing address
address_line2     StringSecond line of the billing address
city     StringCity of the customer's billing address
country     String
ISO 3166 alpha 2 Country code.
Country code of the customer's billing address
email     StringEmail of the customer
legal_name     StringLegal company name of the customer
legal_number     StringLegal company number of the customer
logo_url     StringLogo URL of the customer
name     StringFull name of the customer
phone     StringPhone number of the customer
state     StringState of the customer's billing address
url     StringCustom URL of the customer
vat_rate     FloatCustom VAT rate applied to the customer
zipcode     StringZipcode of the customer's billing address

Billing Configuration Object

AttributesDescription
payment_provider     StringPayment provider used to bill the customer.
Possible values
- stripe: Use stripe as a payment provider.
- null: No payment providers. Only webhooks will be send to process customer billing.
provider_customer_id     StringCustomer ID on the payment provider.