get https://api.chartmogul.com/v1/customers/
Retrieves a customer
object from your ChartMogul account.
Examples
curl -X GET "https://api.chartmogul.com/v1/customers/cus_de305d54-75b4-431b-adb2-eb6b9e546012" \
-u YOUR_API_KEY:
ChartMogul::Customer.retrieve('cus_de305d54-75b4-431b-adb2-eb6b9e546012')
ChartMogul.Customer.retrieve(config, "cus_de305d54-75b4-431b-adb2-eb6b9e546012", function(err, res) {
// asynchronously called
});
<?php
ChartMogul\Customer::retrieve("cus_de305d54-75b4-431b-adb2-eb6b9e546012");
?>
api.RetrieveCustomer("cus_c0dc8d74-edfd-11e6-a357-832dddba822f")
chartmogul.Customer.retrieve(
config,
uuid="cus_c0dc8d74-edfd-11e6-a357-832dddba822f"
)
Result Format
{
"id": 25647,
"uuid": "cus_de305d54-75b4-431b-adb2-eb6b9e546012",
"external_id": "34916129",
"name": "Example Company",
"email": "[email protected]",
"status": "Active",
"customer-since": "2015-06-09T13:16:00-04:00",
"attributes": {
"tags": ["engage", "unit loss", "discountable"],
"stripe": {
"uid": 7,
"coupon": true
},
"clearbit": {
"id": "027b0d40-016c-40ea-8925-a076fa640992",
"name": "Acme",
"legalName": "Acme Inc.",
"domain": "acme.com",
"url": "http://acme.com",
"metrics": {
"raised": 1502450000,
"employees": 1000,
"googleRank": 7,
"alexaGlobalRank": 2319,
"marketCap": null
},
"category": {
"sector": "Information Technology",
"industryGroup": "Software and Services",
"industry": "Software",
"subIndustry": "Application Software"
}
},
"custom": {
"CAC": 213,
"utmCampaign": "social media 1",
"convertedAt": "2015-09-08 00:00:00",
"pro": false,
"salesRep": "Gabi"
}
},
"address": {
"address_zip": "0185128",
"city": "Nowhereville",
"state": "Alaska",
"country": "US"
},
"data_source_uuid": "ds_fef05d54-47b4-431b-aed2-eb6b9e545430",
"data_source_uuids": ["ds_fef05d54-47b4-431b-aed2-eb6b9e545430"],
"external_ids": ["34916129"],
"company": "",
"country": "US",
"state": "Alaska",
"city": "Nowhereville",
"zip": "0185128",
"lead_created_at": null,
"free_trial_started_at": null,
"mrr": 3000,
"arr": 36000,
"billing-system-url": "https:\/\/dashboard.stripe.com\/customers\/cus_4Z2ZpyJFuQ0XMb",
"chartmogul-url": "https:\/\/app.chartmogul.com\/#customers\/25647-Example_Company",
"billing-system-type": "Stripe",
"currency": "USD",
"currency-sign": "$"
}
#<ChartMogul::Customer:0x007faf03b02d68
@id=25647,
@uuid="cus_de305d54-75b4-431b-adb2-eb6b9e546012",
@data_source_uuid="ds_fef05d54-47b4-431b-aed2-eb6b9e545430",
@data_source_uuids=["ds_fef05d54-47b4-431b-aed2-eb6b9e545430"],
@external_id="34916129",
@external_ids=["34916129"],
@name="Example Company",
@email="[email protected]",
@status="Active",
@lead_created_at=null,
@free_trial_started_at=null,
@customer_since=2015-06-09 13:16:00 -04:00:00,
@country="US",
@state="Alaska",
@city="Nowhereville",
@zip="0185128",
@attributes={
:tags=>["engage", "unit loss", "discountable"],
:stripe=>{
:uid=>7,
:coupon=>true
},
:clearbit=>{
:id=>"027b0d40-016c-40ea-8925-a076fa640992",
:name=>"Acme",
:legalName=> "Acme Inc.",
:domain=> "acme.com",
:url=> "http://acme.com",
:metrics=>{
:raised=> 1502450000,
:employees=> 1000,
:googleRank=> 7,
:alexaGlobalRank=> 2319,
:marketCap=> null
},
:category=>{
:sector=> "Information Technology",
:industryGroup=> "Software and Services",
:industry=> "Software",
:subIndustry=> "Application Software"
}
},
:custom=>{
:CAC=> 213,
:utmCampaign=> "social media 1",
:convertedAt=> "2015-09-08 00:00:00",
:pro=> false,
:salesRep=> "Gabi"
}
},
@address={
:address_zip=>"0185128",
:city=>"Nowhereville",
:state=>"Alaska",
:country=>"US"
},
@mrr=3000,
@arr=36000,
@billing_system_url="https:\/\/dashboard.stripe.com\/customers\/cus_4Z2ZpyJFuQ0XMb",
@chartmogul_url="https:\/\/app.chartmogul.com\/#customers\/25647-Example_Company",
@billing_system_type="Stripe",
@currency="USD",
@currency_sign="$"
>
{
"id": 25647,
"uuid": "cus_de305d54-75b4-431b-adb2-eb6b9e546012",
"external_id": "34916129",
"name": "Example Company",
"email": "[email protected]",
"status": "Active",
"customer-since": "2015-06-09T13:16:00-04:00",
"attributes": {
"tags": ["engage", "unit loss", "discountable"],
"stripe": {
"uid": 7,
"coupon": true
},
"clearbit": {
"id": "027b0d40-016c-40ea-8925-a076fa640992",
"name": "Acme",
"legalName": "Acme Inc.",
"domain": "acme.com",
"url": "http://acme.com",
"metrics": {
"raised": 1502450000,
"employees": 1000,
"googleRank": 7,
"alexaGlobalRank": 2319,
"marketCap": null
},
"category": {
"sector": "Information Technology",
"industryGroup": "Software and Services",
"industry": "Software",
"subIndustry": "Application Software"
}
},
"custom": {
"CAC": 213,
"utmCampaign": "social media 1",
"convertedAt": "2015-09-08 00:00:00",
"pro": false,
"salesRep": "Gabi"
}
},
"address": {
"address_zip": "0185128",
"city": "Nowhereville",
"state": "Alaska",
"country": "US"
},
"data_source_uuid": "ds_fef05d54-47b4-431b-aed2-eb6b9e545430",
"data_source_uuids": ["ds_fef05d54-47b4-431b-aed2-eb6b9e545430"],
"external_ids": ["34916129"],
"company": "",
"country": "US",
"state": "Alaska",
"city": "Nowhereville",
"zip": "0185128",
"lead_created_at": null,
"free_trial_started_at": null,
"mrr": 3000,
"arr": 36000,
"billing-system-url": "https:\/\/dashboard.stripe.com\/customers\/cus_4Z2ZpyJFuQ0XMb",
"chartmogul-url": "https:\/\/app.chartmogul.com\/#customers\/25647-Example_Company",
"billing-system-type": "Stripe",
"currency": "USD",
"currency-sign": "$"
}
<?php
ChartMogul\Customer::__set_state(array(
"id" => 25647,
"uuid" => "cus_de305d54-75b4-431b-adb2-eb6b9e546012",
"external_id" => "34916129",
"name" => "Example Company",
"email" => "[email protected]",
"status" => "Active",
"customer_since" => "2015-06-09T13:16:00-04:00",
"attributes" =>
array (
"custom" =>
array (
"CAC" => 213,
"utmCampaign" => "social media 1",
"convertedAt" => "2015-09-08 00 =>00 =>00",
"pro" => false,
"salesRep" => "Gabi"
),
"clearbit" =>
array (
"id" => "027b0d40-016c-40ea-8925-a076fa640992",
"name" => "Acme",
"legalName" => "Acme Inc.",
"domain" => "acme.com",
"url" => "http =>//acme.com",
"metrics" => array (
"raised" => 1502450000,
"employees" => 1000,
"googleRank" => 7,
"alexaGlobalRank" => 2319,
"marketCap" => null
),
"category" => array (
"sector" => "Information Technology",
"industryGroup" => "Software and Services",
"industry" => "Software",
"subIndustry" => "Application Software"
)
),
"stripe" =>
array (
"uid" => 7,
"coupon" => true
),
"tags" =>
array (
0 => "engage",
1 => "unit loss",
2 => "discountable"
),
),
"address" =>
array (
"address_zip" => "0185128",
"city" => "Nowhereville",
"state" => "Alaska",
"country" => "US"
),
"mrr" => 3000,
"arr" => 36000,
"billing_system_url" => "https:\/\/dashboard.stripe.com\/customers\/cus_4Z2ZpyJFuQ0XMb",
"chartmogul_url" => "https:\/\/app.chartmogul.com\/#customers\/25647-Example_Company",
"billing_system_type" => "Stripe",
"currency" => "USD",
"currency_sign" => "$",
"data_source_uuid" => "ds_80686670-cc45-11e6-b9da-ff67b9895fe3",
"data_source_uuids" =>
array (
0 => "ds_80686670-cc45-11e6-b9da-ff67b9895fe3",
),
"external_ids" =>
array (
0 => "cus_0001",
),
"city" => "Nowhereville",
"country" => "US",
"state" => "Alaska",
"zip" => "0185128",
"lead_created_at" => "2015-10-14T00:00:00.000Z",
"free_trial_started_at" => "2015-11-01T00:00:00.000Z",
"company" => ""
));
?>
(*chartmogul.Customer)(0xc04207e6e0)({
ID: (uint32) 4861688,
DataSourceUUID: (string) (len=39) "ds_9bb53a1e-edfd-11e6-bf83-af49e978cb11",
DataSourceUUIDs: ([]string) {
(len=39) "ds_9bb53a1e-edfd-11e6-bf83-af49e978cb11"
},
UUID: (string) (len=40) "cus_c0dc8d74-edfd-11e6-a357-832dddba822f",
ExternalID: (string) (len=8) "cus_0001",
ExternalIDs: ([]string) {
(len=8) "cus_0001"
},
Name: (string) (len=10) "Adam Smith",
Email: (string) (len=14) "[email protected]",
Status: (string) (len=6) "Active",
CustomerSince: (string) (len=25) "2015-11-01T00:00:00+00:00",
Attributes: (*chartmogul.Attributes)(0xc042132b10)({
Tags: ([]string) {
},
Stripe: (*chartmogul.Stripe)(0xc04212f5d0)({
UID: (uint64) 0,
Coupon: (bool) false
}),
Clearbit: (*chartmogul.Clearbit)(0xc0420f8cc0)({
ID: (string) "",
Name: (string) "",
LegalName: (string) "",
Domain: (string) "",
URL: (string) "",
Metrics: (map[string]interface {}) <nil>,
Category: (*chartmogul.Category)(<nil>)
}),
Custom: (map[string]interface {}) {
}
}),
Address: (*chartmogul.Address)(0xc042009800)({
AddressZIP: (string) "",
City: (string) (len=8) "New York",
State: (string) "",
Country: (string) (len=13) "United States"
}),
Mrr: (float64) 4100,
Arr: (float64) 49200,
BillingSystemURL: (string) "",
ChartmogulURL: (string) (len=56) "https://app.chartmogul.com/#customers/4861688-Adam_Smith",
BillingSystemType: (string) (len=10) "Custom",
Currency: (string) (len=3) "USD",
CurrencySign: (string) (len=1) "$",
Company: (string) "",
Country: (string) (len=2) "US",
State: (string) "",
City: (string) (len=8) "New York",
Zip: (string) "",
LeadCreatedAt: (string) (len=24) "2015-10-14T00:00:00.000Z",
FreeTrialStartedAt: (string) (len=24) "2015-11-01T00:00:00.000Z",
Errors: (chartmogul.Errors) chartmogul: map[]
})
<Customer{
address=<Address{
address_zip=None,
city='New York',
country='United States',
state=None}>,
arr=49200.0,
attributes=<Attributes{
clearbit=<Clearbit{
}>,
custom={
},
stripe=<Stripe{
}>,
tags=[]}>,
billing_system_type='Custom',
billing_system_url=None,
chartmogul_url='https://app.chartmogul.com/#customers/4861688-Adam_Smith',
city='New York',
company='',
country='US',
currency='USD',
currency_sign='$',
customer_since=datetime.datetime(2015, 11, 1, 0, 0),
data_source_uuid='ds_9bb53a1e-edfd-11e6-bf83-af49e978cb11',
data_source_uuids=['ds_9bb53a1e-edfd-11e6-bf83-af49e978cb11'],
email='[email protected]',
external_id='cus_0001',
external_ids=['cus_0001'],
free_trial_started_at=datetime.datetime(2015, 11, 1, 0, 0),
id=4861688,
lead_created_at=datetime.datetime(2015, 10, 14, 0, 0),
mrr=4100.0,
name='Adam Smith',
state=None,
status='Active',
uuid='cus_c0dc8d74-edfd-11e6-a357-832dddba822f',
zip=None}>
In the response, the JSON
object contains the following data:
id
- The internal ChartMogul ID of thecustomer
object.uuid
- The UUID of thecustomer
object generated by ChartMogul.external_id
- The unique external identifier for this customer, if any.external_ids
- An array containing the unique external identifiers of all customer records that have been merged into this customer.data_source_uuid
- The ChartMogul UUID of the data source of this customer.data_source_uuids
- An array containing the ChartMogul UUIDs of all data sources that contribute data to this customer. This is most relevant for merged customers.name
- The name of this customer.email
- This customer's email address.company
- This customer's company name.status
- The status of this customer. One ofLead
,Active
,Past Due
orCancelled
.lead_created_at
- The time at which this customer was established as a lead, as specified by you.free_trial_started_at
- The time at which this customer started a free trial of your product or service, as specified by you.customer-since
- An RFC3339 formatted datetime attribute indicating when the customer first started paying for a subscription.country
- The country from the customer's address.state
- The state from the customer's address.city
- The city from the customer's address.zip
- The zip code from the customer's address.attributes
- A JSON object representing this customer's attributes containing the following data:tags
- An Array of tags that you have added to this customer.stripe
- A JSON object representing any metadata on this customer object in your Stripe account.clearbit
- A JSON object representing publicly available information about this customer retrieved from Clearbit.custom
- A JSON object representing custom attributes that you have added to this customer.
address
- A JSON object representing this customer's address containing the following data:address_zip
- The zip code from this customer's address.city
- The city from this customer's address.state
- The state from this customer's address.country
- The country code from this customer's address as per the ISO-3166 alpha-2 standard.
mrr
- The current monthly recurring revenue for this customer, expressed in the currency selected for your account, as an integer number of cents. Divide by 100 to obtain the actual amount.arr
- The current annual run rate for this customer, also expressed as an integer number of cents in your account's selected currency.billing-system-url
- A URL for this customer's data in your billing system, if available.chartmogul-url
- The URL for this customer's ChartMogul page. This is only accessible to a user logged in to your ChartMogul account.billing-system-type
- The type of the billing system from where the customer was imported to ChartMogul. For example,Stripe
,Recurly
,Chargify
, orCustom
.currency
- The currency of the MRR readings for this customer.currency-sign
- Text representation to display the currency. E.g. $, or €.