Swipelux
Customer API

Get a customer by ID

Retrieve a customer by ID

GET
/v1/customers/{id}

Authorization

X-API-Key<token>

In: header

Path Parameters

idRequiredstring

The customer ID

Response Body

The customer has been retrieved successfully

idRequiredstring

A unique identifier for the customer

firstNameRequiredstring

The first name of the customer

Minimum length: 1Maximum length: 1024
middleNamestring

The middle name of the customer

Minimum length: 1Maximum length: 1024
lastNameRequiredstring

The last name of the customer

Minimum length: 1Maximum length: 1024
emailRequiredstring

The primary email address of the customer

Format: "email"
phoneRequiredstring

The primary phone number of the customer in E.164 format (e.g., +1234567890)

Minimum length: 1Maximum length: 32
statusRequiredunknown

The KYC verification status of the customer

Value in: "not_started" | "incomplete" | "under_review" | "approved" | "rejected"
metadataobject

The provided metadata of the customer

createdAtRequiredstring

The creation date of the customer

Format: "date-time"
updatedAtRequiredstring

The last update date of the customer

Format: "date-time"
export interface Response {
  /**
   * A unique identifier for the customer
   */
  id: string;
  /**
   * The first name of the customer
   */
  firstName: string;
  /**
   * The middle name of the customer
   */
  middleName?: string;
  /**
   * The last name of the customer
   */
  lastName: string;
  /**
   * The primary email address of the customer
   */
  email: string;
  /**
   * The primary phone number of the customer in E.164 format (e.g., +1234567890)
   */
  phone: string;
  /**
   * The KYC verification status of the customer
   */
  status: "not_started" | "incomplete" | "under_review" | "approved" | "rejected";
  /**
   * The provided metadata of the customer
   */
  metadata?: {
    [k: string]: string | number | boolean;
  };
  /**
   * The creation date of the customer
   */
  createdAt: string;
  /**
   * The last update date of the customer
   */
  updatedAt: string;
}
 
curl -X GET "https://wallet.swipelux.com/v1/customers/string" \
  -H "X-API-Key: <token>"
{
  "id": "string",
  "firstName": "string",
  "middleName": "string",
  "lastName": "string",
  "email": "user@example.com",
  "phone": "string",
  "status": "not_started",
  "metadata": {
    "property1": "string",
    "property2": "string"
  },
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}