Back to ChartMogulAPI referenceGuides and tutorialsSupportContact

Retrieve a Customer

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 the customer object.
  • uuid - The UUID of the customer 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 of Lead, Active, Past Due or Cancelled.
  • 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, or Custom.
  • currency - The currency of the MRR readings for this customer.
  • currency-sign - Text representation to display the currency. E.g. $, or €.
Language
Authentication
Basic
base64
: