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

# Customers

> Understand how Bob associates buyers, registration data, and transactions.

A customer represents the buyer within your project. The resource gathers registration data and lets you query the transactions associated with that person or company.

## When to use

Send the customer data when creating a transaction. Bob uses this information to process the payment, apply validations, and maintain the project's history.

The required fields depend on the operation. Check the reference before assembling the payload.

## Scope and security

* The customer belongs to the project associated with your API key.
* Query and update customer data only on the backend.
* Collect only the data necessary for the payment.
* Never log full personal data in application logs.

## Next steps

<CardGroup cols={3}>
  <Card title="Customer structure" icon="book-open" href="/en/pages/customers/reference">
    Check the published fields for the resource.
  </Card>

  <Card title="Get by ID" icon="magnifying-glass" href="/en/pages/customers/get">
    Retrieve a specific customer.
  </Card>

  <Card title="List customers" icon="list" href="/en/pages/customers/list">
    Query the project's customers.
  </Card>
</CardGroup>