Find Customer Schemas

API endpoints for discovering customers within the Peere Network.

Endpoints

Method	Endpoint	Description
GET	`/v1/customer/banks`	Find banks associated with customer email
POST	`/v1/customer/device/lookup`	Identify customer through device fingerprinting

GET /v1/customer/banks

Find which banks a customer is associated with using their email address.

Query Parameters

Parameter	Type	Required	Description
`email`	string	Yes	Customer email address

Response Schema

{
  "statusCode": 200,
  "success": true,
  "message": "Customer banks retrieved successfully",
  "data": {
    "banks": [
      {
        "bankId": "string",
        "bankName": "string",
        "accountName": "string",
        "phrase": "string",
        "customerName": "string"
      }
    ]
  }
}

Response Fields

Field	Type	Description
`bankId`	string	Unique bank identifier
`bankName`	string	Bank name
`accountName`	string	Masked account identifier
`phrase`	string	Lookup ID for transactions
`customerName`	string	Obfuscated customer name

POST /v1/customer/device/lookup

Identify customers through device fingerprinting for returning customer recognition.

Request Body

{
  "deviceId": "string"
}

Request Schema

Field	Type	Required	Description
`deviceId`	string	Yes	Device identifier for lookup

Response Schema

{
  "statusCode": 200,
  "success": true,
  "message": "Device lookup successful",
  "data": {
    "bankId": "string",
    "bankName": "string",
    "accountName": "string",
    "phrase": "string",
    "customerName": "string"
  }
}

Response Fields

Field	Type	Description
`bankId`	string	Associated bank identifier
`bankName`	string	Bank name
`accountName`	string	Masked account information
`phrase`	string	Lookup ID for billing
`customerName`	string	Privacy protected customer name

Error Responses

400 Bad Request

{
  "statusCode": 400,
  "success": false,
  "message": "Invalid email format"
}

404 Not Found

{
  "statusCode": 404,
  "success": false,
  "message": "Device not found in system"
}

Account Operations

Find Customer

Billing & Payment Operations

Recurring Billing

Customer Decisions

Refund Management

Transaction Management

Balance & Financial Operations

Shared Operations

schemas

Find Customer Schemas

Endpoints

GET /v1/customer/banks

Query Parameters

Response Schema

Response Fields

POST /v1/customer/device/lookup

Request Body

Request Schema

Response Schema

Response Fields

Error Responses

400 Bad Request

404 Not Found

​Find Customer Schemas

​Endpoints

​GET /v1/customer/banks

​Query Parameters

​Response Schema

​Response Fields

​POST /v1/customer/device/lookup

​Request Body

​Request Schema

​Response Schema

​Response Fields

​Error Responses

​400 Bad Request

​404 Not Found

Find Customer Schemas

Endpoints

GET /v1/customer/banks

Query Parameters

Response Schema

Response Fields

POST /v1/customer/device/lookup

Request Body

Request Schema

Response Schema

Response Fields

Error Responses

400 Bad Request

404 Not Found