---
title: "Get Customer History"
method: GET
path: "/api/v1/payment/history"
---

# Get Customer History

`GET /api/v1/payment/history`

## Request

- Base URL: `https://sandbox.interswitchng.com`
- URL: `https://sandbox.interswitchng.com/api/v1/payment/history`
- Auth: none required

This endpoint will be used by providers to retrieve information of a customer from the Platform.
Please note that, currently, this request will be pass to ESB Service and not ILS Service.

## Headers

- `Authorization` string
- `SignatureMethod` string
- `Timestamp` string
- `startDate` string
- `endDate` string
- `mobile` string
- `Nonce` string

## Request body

- object
  - `providerCode` string, required: The Code of the Channel from which this request originates. Max length: 50
  - `mobile` string, required: The ID of the customer whose Information the provider is trying to get. Max length: 50
  - `startDate` string, date, required: The Date from which history will be retrieved. Format: yyyy-mm-dd. Max length: 10
  - `endDate` string, required: The Date to which history will be retrieved. Format: yyyy-mm-dd. Max length: 10

## Response `200`

200

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/interswitchgroup/apis/ipg.md) - [All operations](https://skmtc.dev/interswitchgroup/apis/ipg/llms.txt) - [OpenAPI document](https://skmtc.dev/interswitchgroup/apis/ipg/revisions/98dead048190?raw)