Get customer

A Customer Profile with contact details, current assignee, open Tasks and the list of their Conversations.

GET https://cotlet.dev/api/v1/gladly/customers/{customer_id}

read

Returns the profile as the Customer Profile screen shows it: name, emails, phones, address, who the customer is assigned to, open Tasks, and each Conversation with its status and Topics. A profile that was merged into another one returns the surviving profile. Use conversation_id with get_conversation.

Parameters

Parameters: get_customer
NameTypeDescription
customer_id string required string Customer ID from search_customers or list_my_customers.

Request

cURL
curl https://cotlet.dev/api/v1/gladly/customers/customer_8c41d2 \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("gladly", "get_customer", {"customer_id":"customer_8c41d2"})
Node.js
const result = await cotlet.call('gladly', 'get_customer', {"customer_id":"customer_8c41d2"});
CLI
cotlet call gladly get_customer --data '{"customer_id":"customer_8c41d2"}'

Example response

JSON

{
  "customer_id": "o2sg-TMTSD2rTwMuxzewbA",
  "name": "Marco Silva",
  "emails": [
    "marco.silva@example.com"
  ],
  "phones": [
    "+14155550142"
  ],
  "assigned_to": {
    "inbox": "Email Inbox",
    "agent": "Priya Nair"
  },
  "open_tasks": [
    {
      "task_id": "pOVVdzweSumI4bFxjlT8LA",
      "body": "Call back about the exchange",
      "due_at": "2026-10-22T17:00:00Z",
      "owner": "Priya Nair"
    }
  ],
  "conversations": [
    {
      "conversation_id": "HXRqKC5GSV-jAlq0-sxYTA",
      "status": "open",
      "topics": [
        "Order Status"
      ]
    },
    {
      "conversation_id": "Qm4vT8cLw1RzNe6JhB3yUg",
      "status": "closed",
      "topics": [
        "Exchange > Size"
      ]
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.