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

# Fetch Customer Details

***

## icon: user-round-search

# Fetch Customer

Use the Fetch Customer API to retrieve the details of a specific customer using their unique KwikPaisa Neo Bank customer ID.

This API returns the customer's profile information, contact details, address, current status, and creation and update timestamps.

***

## Endpoint

```text theme={null}
GET /api/v3/pg/customer/{customer_id}
```

***

#### To view all available base URLs and environments, refer to:

➡️ [API Resources](https://docs.kwikpaisa.com/guide/quick-start/api-resources.md)

#### This endpoint requires standard KwikPaisa Neo Bank authentication headers.

Refer to:

➡️ [Headers](https://docs.kwikpaisa.com/guide/authentication/headers.md)\
➡️ [Signature Generation](https://docs.kwikpaisa.com/guide/authentication/signature.md)\
➡️ [Timestamp Validation](https://docs.kwikpaisa.com/guide/authentication/timestamp.md)

***

## Request Parameters

| Parameter | Type | Required | Description |
| :- | :- | :- | :- |
| `customer_id` | String | Yes | Unique KwikPaisa Neo Bank customer ID (`cust_...`) passed in the URL path |

***

## Example cURL Request

```text theme={null}
curl --request GET \
--url https://sandbox.kwikpaisa.com/api/v3/pg/customer/cust_d71f980e-4b3f-4e9b-9d14-7cfa92fd9134 \
--header "Accept: application/json" \
--header "X-API-KEY: pk_test_xxxxxxxxx" \
--header "X-TIMESTAMP: GENERATED_TIMESTAMP" \
--header "X-SIGNATURE: GENERATED_SIGNATURE"
```

***

## Signature Generation

For this GET request, generate the signature using an empty payload.

```text theme={null}
$timestamp = time();
$payload = [];

$jsonPayload = json_encode($payload, JSON_UNESCAPED_SLASHES);

$signature = hash_hmac(
    'sha256',
    $jsonPayload . $timestamp,
    $secretKey
);
```

***

## Example Success Response

```text theme={null}
{
  "success": true,
  "message": "Customer fetched successfully",
  "customer": {
    "name": "Rahul Sharma",
    "email": "rahul@example.com",
    "phone": "9999999999",
    "address": {
      "line1": "House No. 101, Sector 15",
      "line2": "Near City Park",
      "city": "Hisar",
      "state": "Haryana",
      "country": "India",
      "postal_code": "125001"
    },
    "x_customer_id": "cust_d71f980e-4b3f-4e9b-9d14-7cfa92fd9134",
    "status": "active",
    "created_at": "2026-11-11T09:49:43.000000Z",
    "updated_at": "2026-11-11T09:49:43.000000Z"
  }
}
```

***

## Response Parameters

| Parameter | Description |
| :- | :- |
| `success` | Indicates whether the customer was fetched successfully |
| `message` | API response message |
| `customer.name` | Customer's full name |
| `customer.email` | Customer's email address |
| `customer.phone` | Customer's mobile number |
| `customer.address` | Customer's address details |
| `customer.address.line1` | Primary address line |
| `customer.address.line2` | Secondary address line |
| `customer.address.city` | Customer's city |
| `customer.address.state` | Customer's state |
| `customer.address.country` | Customer's country |
| `customer.address.postal_code` | Customer's postal/ZIP code |
| `customer.x_customer_id` | Unique KwikPaisa Neo Bank generated customer ID |
| `customer.status` | Current customer status |
| `customer.created_at` | Customer creation timestamp |
| `customer.updated_at` | Customer last update timestamp |

***

## Important Notes

* Provide a valid `customer_id` in the endpoint URL.
* The `customer_id` must be the unique ID generated by KwikPaisa Neo Bank during customer creation.
* The API retrieves the customer associated with the authenticated merchant account.
* Store the `x_customer_id` returned in the response for future customer-related operations.
* Generate API signatures on your server only.
* Use HTTPS for all API requests.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.