Skip to main content
GET
Get Customer

Description

This endpoint returns all available information for a specific customer, including their personal data, statistics, bookings, and custom fields.

Authentication

string
required
Your LatePoint API Key with read permissions

Path Parameters

integer
required
Unique ID of the customer to retrieve

Query Parameters

Included Fields

string
Additional fields to include in the response (comma-separated)Possible values:
  • bookings - Include all customer bookings
  • upcoming_bookings - Only future bookings
  • past_bookings - Only past bookings
  • stats - Include detailed statistics
  • custom_fields - Include custom fields
  • notes - Include customer notes
  • avatar - Include avatar information
integer
default:"10"
Limit of bookings to include (when including bookings)
string
Filter bookings by specific statusPossible values:
  • pending - Pending
  • confirmed - Confirmed
  • completed - Completed
  • cancelled - Cancelled
  • no_show - No show

Response

Successful Response (200 OK)

string
Response status (“success”)
object
Complete customer object

Examples

Get Basic Customer

Get Customer with Complete Information

Get Only Future Bookings

Example Response

Complete Customer

Error Codes

Common Use Cases

1. Complete Customer Profile

2. Check Booking History

3. Customer Information Widget

4. Customer Validation for Bookings

Best Practices

1. Efficient Use of Include Parameter

2. Customer Data Caching

3. Robust Error Handling

Important Notes

Sensitive Information: Customer data may include sensitive information. Make sure to handle it according to applicable privacy regulations.
Optimization: Use the include parameter selectively to get only the data you need and improve performance.
Cache: If you implement customer data caching, make sure to invalidate it when customer information is updated.
Statistics: Statistics are calculated in real time, so they may affect response time if the customer has many bookings.