Skip to main content
GET
/
api
/
v1
/
customers
/
{id}
.json
Get Customer
curl --request GET \
  --url https://api.launchmystore.io/api/v1/customers/{id}.json \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "id": "<string>",
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "phone": "<string>",
    "verified_email": true,
    "accepts_marketing": true,
    "accepts_marketing_updated_at": "<string>",
    "orders_count": 123,
    "total_spent": 123,
    "currency": "<string>",
    "tags": [
      {}
    ],
    "note": "<string>",
    "tax_exempt": true,
    "addresses": [
      {}
    ],
    "default_address": {},
    "last_order_id": "<string>",
    "last_order_date": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>"
  }
}

​
Get Customer

Returns a single customer with full details including addresses and order history summary.

​
Request

curl -X GET "https://api.launchmystore.io/api/v1/customers/cust_abc123.json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Parameters

​
id
string
required
The unique customer ID
​
fields
string
Comma-separated list of fields to include in the response

​
Response

​
success
boolean
Whether the request succeeded
​
data
object
The customer object

​
Example Response

{
  "success": true,
  "data": {
    "id": "cust_abc123",
    "email": "john.doe@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "phone": "+1-555-123-4567",
    "verified_email": true,
    "accepts_marketing": true,
    "accepts_marketing_updated_at": "2023-06-15T10:30:00Z",
    "orders_count": 5,
    "total_spent": 25000,
    "currency": "USD",
    "tags": ["VIP", "wholesale"],
    "note": "Prefers express shipping",
    "tax_exempt": false,
    "addresses": [
      {
        "id": "addr_123",
        "first_name": "John",
        "last_name": "Doe",
        "company": "Acme Inc",
        "address1": "123 Main St",
        "address2": "Suite 100",
        "city": "New York",
        "province": "NY",
        "province_code": "NY",
        "country": "United States",
        "country_code": "US",
        "zip": "10001",
        "phone": "+1-555-123-4567",
        "default": true
      },
      {
        "id": "addr_456",
        "first_name": "John",
        "last_name": "Doe",
        "address1": "456 Oak Ave",
        "city": "Los Angeles",
        "province": "CA",
        "province_code": "CA",
        "country": "United States",
        "country_code": "US",
        "zip": "90001",
        "default": false
      }
    ],
    "default_address": {
      "id": "addr_123",
      "address1": "123 Main St",
      "city": "New York",
      "province": "NY",
      "country": "US",
      "zip": "10001"
    },
    "last_order_id": "ord_xyz789",
    "last_order_date": "2024-01-15T10:30:00Z",
    "created_at": "2023-06-15T10:30:00Z",
    "updated_at": "2024-01-20T14:45:00Z"
  }
}

​
Error Codes

CodeDescription
UNAUTHORIZEDInvalid or missing access token
FORBIDDENApp doesn’t have read_customers scope
NOT_FOUNDCustomer with the specified ID does not exist