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

# Overview

A customer is either an individual or business entity that can be issued a payment card.

**Endpoints**

| Method | Url                                                                       |
| ------ | ------------------------------------------------------------------------- |
| `POST` | [/customers](/reference/create-customer)                                  |
| `GET`  | [/customers](/reference/get-customers)                                    |
| `GET`  | [/customers/:id](/reference/get-customer)                                 |
| `PUT`  | [/customers/:id](/reference/update-customer)                              |
| `PUT`  | [/customers/:id/documents/url](/reference/generate-customer-document-url) |

**Customer** **Object**

<CodeGroup>
  ```json RESPONSE (STANDARD) theme={null}
  {
      "_id": "61d4311000c7cdd1184ef76a",
      "business": "61d4150b00c7cdd1384f2355",
      "type": "individual",
      "name": "John Doe",
      "status": "active",
      "individual": {
          "firstName": "John",
          "lastName": "Doe",
          "_id": "61dc10951160e92757b1c4a1"
      },
      "billingAddress": {
          "line1": "Ikeja, Lagos",
          "line2": "",
          "city": "Lagos",
          "state": "Lagos",
          "country": "Nigeria",
          "postalCode": "100001",
          "_id": "61d4311000c7cdd1184ef76d"
      },
      "emailAddress": "[email protected]",
      "phoneNumber": "+234 8145431688",
      "metadata": {
          "name": "john"
      }
  }
  ```
</CodeGroup>