---
title: "Customers overview"
description: "Create and manage customer records."
---

# Customers overview

Use the Customers API to create customer records, list customers, retrieve an individual customer, and update customer information.

<CardGroup cols={2}>
  <Card title="Browse customer endpoints" icon="code" href="/api-reference/customers/post-v1-customers">
    Create a customer or browse the operations in this category.
  </Card>
  <Card title="Onboard your first customer" icon="book" href="/getting-started/onboard-your-first-customer">
    Follow the end-to-end customer onboarding guide.
  </Card>
</CardGroup>

## How it works

The customer is the root record that everything else in Gravv attaches to — KYC verification, accounts, wallets, cards, and transfers all reference a `customer_id`. A typical onboarding sequence is:

1. [Create the customer](/api-reference/customers/post-v1-customers) with their personal or business details.
2. [Verify the customer](/api-reference/kyc/overview) through KYC.
3. Open [accounts](/api-reference/accounts/overview), [wallets](/api-reference/wallets/overview), or [cards](/api-reference/cards/overview) for the verified customer.

## Endpoints

| Endpoint | Description |
|---|---|
| [`POST /v1/customers`](/api-reference/customers/post-v1-customers) | Create a customer record |
| [`GET /v1/customers`](/api-reference/customers/get-v1-customers) | List customers with filters and pagination |
| [`GET /v1/customers/{customer_id}`](/api-reference/customers/get-v1-customers-customer-id) | Retrieve a single customer |
| [`PUT /v1/customers/{customer_id}`](/api-reference/customers/put-v1-customers-customer-id) | Update a customer — only provided fields are updated |

<Note>
When updating a customer, the service reads `customer_id` from the request body (where it is required); the path parameter is cosmetic. Updates are partial — fields you omit keep their current values.
</Note>

## Authentication

All requests use `https://api.gravv.xyz/v1/` and authenticate with the `Api-Key` header. See [Authentication](/getting-started/authentication) for details.