Show Customer

GET /api/v1/customers/:id

Retrieve detailed information for a specific customer by ID.

Description

Fetches a single customer record, including nested address and timestamps. Useful for viewing or editing customer profiles.

Path Parameters

Query Parameters

None.

Request Headers

Request Example

curl -X GET "https://koteshen.com/api/v1/customers/13" \
  -H "Authorization: Bearer <access_token>" \
  -H "Accept: application/json"

Response

• Status Code: 200 OK
• Content-Type: application/json

Success Response Body

{
  "id": 13,
  "name": "Texas Ins",
  "company": "Texas Ins",
  "customer_type": "business",
  "phone": "+27675711214",
  "phone_country": "za",
  "currency": "zar",
  "email": "procurement@texas.com",
  "website": "https://texas.com",
  "business_id": 1,
  "notes": "notesy",
  "created_at": "2025-10-12T19:00:37.057Z",
  "updated_at": "2025-10-12T19:09:27.293Z",
  "address": {
    "id": 26,
    "line": "1 Mahem Pl",
    "line2": "Unit 23",
    "post_code": "5256",
    "city": "East London",
    "country": "South Africa",
    "created_at": "2025-10-12T19:09:27.300Z",
    "updated_at": "2025-10-12T19:09:27.300Z"
  },
  "url": "https://koteshen.com/api/v1/customers/13.json"
}

Error Responses

• 401 Unauthorized: { "error": "Unauthorized" }
• 404 Not Found: { "error": "Customer not found" }

Usage Notes

• Validate customer existence before linking to invoices.
• The url field provides a direct link for further actions.