> ## Documentation Index
> Fetch the complete documentation index at: https://devdraft.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a customer by ID

> Retrieves detailed information about a specific customer.
    
This endpoint allows you to fetch complete customer details including their contact information and status.

## Use Cases
- View customer details
- Verify customer information
- Check customer status before processing payments

## Path Parameters
- `id`: Customer UUID (required) - Must be a valid UUID format

## Example Request
`GET /api/v0/customers/123e4567-e89b-12d3-a456-426614174000`

## Example Response
```json
{
  "id": "cust_123456",
  "first_name": "John",
  "last_name": "Doe",
  "email": "john.doe@example.com",
  "phone_number": "+1-555-123-4567",
  "customer_type": "Enterprise",
  "status": "ACTIVE",
  "last_spent": 1250.50,
  "last_purchase_date": "2024-03-15T14:30:00Z",
  "created_at": "2024-03-20T10:00:00Z",
  "updated_at": "2024-03-20T10:00:00Z"
}
```



## OpenAPI

````yaml /swagger.yml get /api/v0/customers/{id}
openapi: 3.0.0
info:
  title: Devdraft AI Payment & Business Management API
  description: >-

    A comprehensive payment processing and business management API that enables
    seamless integration of cryptocurrency and traditional payment methods.
        
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.devdraft.ai
    description: Production Server
security: []
tags: []
paths:
  /api/v0/customers/{id}:
    get:
      tags:
        - Customers
      summary: Get a customer by ID
      description: >-
        Retrieves detailed information about a specific customer.
            
        This endpoint allows you to fetch complete customer details including
        their contact information and status.


        ## Use Cases

        - View customer details

        - Verify customer information

        - Check customer status before processing payments


        ## Path Parameters

        - `id`: Customer UUID (required) - Must be a valid UUID format


        ## Example Request

        `GET /api/v0/customers/123e4567-e89b-12d3-a456-426614174000`


        ## Example Response

        ```json

        {
          "id": "cust_123456",
          "first_name": "John",
          "last_name": "Doe",
          "email": "john.doe@example.com",
          "phone_number": "+1-555-123-4567",
          "customer_type": "Enterprise",
          "status": "ACTIVE",
          "last_spent": 1250.50,
          "last_purchase_date": "2024-03-15T14:30:00Z",
          "created_at": "2024-03-20T10:00:00Z",
          "updated_at": "2024-03-20T10:00:00Z"
        }

        ```
      operationId: CustomerController_findOne
      parameters:
        - name: id
          required: true
          in: path
          description: Customer unique identifier (UUID)
          schema:
            format: uuid
            example: cust_123e4567-e89b-12d3-a456-426614174000
            type: string
      responses:
        '200':
          description: Successfully retrieved customer
        '400':
          description: Bad Request - Invalid customer ID format
        '401':
          description: Unauthorized - Invalid API credentials
        '404':
          description: Not Found - Customer not found
      security:
        - x-client-secret: []
        - x-client-key: []
components:
  securitySchemes:
    x-client-secret:
      type: apiKey
      in: header
      name: x-client-secret
      description: >-
        Your secret API key. Keep this secure and never expose it in client-side
        code.
    x-client-key:
      type: apiKey
      in: header
      name: x-client-key
      description: Your unique client API key. Obtain this from your Devdraft AI dashboard.

````