Skip to content
use-forever Docs
Esc
navigateopen⌘Jpreview

List customers

Returns all customers for the authenticated user, ordered by creation date descending.

GET/v1/customers
Authorization
AuthorizationBearer token (JWT) · headerrequired
Responses
200Customers retrieved successfully.
Array of Customer
idstringrequired
namestringrequired
min length 1 · max length 120
phonestringrequired
matches ^\+?[0-9()\s-]{7,20}$
channelsstring[]required
min items 1
Request
curl -X GET "https://api.hackathon.space/v1/customers" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
[
  {
    "id": "cus_123",
    "name": "Jane Doe",
    "phone": "+60123456789",
    "channels": [
      "telegram",
      "twilio-sms"
    ]
  }
]