---
title: "Fetch a list of customers"
url: "https://kongair.kong-sales-engineering.com/apis/customer-information/versions/a20074e9-8ec3-4c7a-b5e7-1d08834f75d6/operations/get-customers"
---

> Full API specification: https://kongair.kong-sales-engineering.com/apis/customer-information/versions/a20074e9-8ec3-4c7a-b5e7-1d08834f75d6.md

# Fetch a list of customers

`GET` `/customers`

Operation ID: `get-customers`

Fetch a list of customer objects

## Responses

- `200` - A list of customers
- `404` - Customers Not Found

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Customer Information Service
  version: 0.1.0
servers:
  - url: https://shared-services.kong-sales-engineering.com/kongair
    description: KongAir API Server
paths:
  /customers:
    get:
      summary: Fetch a list of customers
      description: Fetch a list of customer objects
      tags:
        - customer
      operationId: get-customers
      responses:
        "200":
          description: A list of customers
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/Customer"
        "404":
          description: Customers Not Found
security:
  - basicAuth: []
components:
  schemas:
    Customer:
      type: object
      properties:
        id:
          type: string
        username:
          type: string
        name:
          type: string
        information:
          $ref: "#/components/schemas/CustomerInformation"
    CustomerInformation:
      type: object
      properties:
        address:
          type: string
        phone_number:
          type: string
        email:
          type: string
        frequent_flier_number:
          type: string
        payment_methods:
          type: array
          items:
            $ref: "#/components/schemas/PaymentMethod"
    PaymentMethod:
      type: object
      properties:
        id:
          type: string
        redacted_card_number:
          type: string
        card_holder_name:
          type: string
        expiration-date:
          type: string
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
```