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

# Customers

> Query customer and organization data.

## me

Returns the authenticated customer's profile.

```graphql theme={null}
query {
  me {
    id
    name
    email
    organization {
      id
      name
      tier
      apiQuota {
        requestsPerMinute
        calculationsPerDay
        used { requests calculations }
      }
    }
  }
}
```

## customer

Retrieve a specific customer by ID (Enterprise tier only).

```graphql theme={null}
query {
  customer(id: "cust_123") {
    id
    name
    email
    impactProfile {
      totalCo2Saved
      badges { name tier earnedAt }
      milestones { name current target percentage }
    }
  }
}
```

**Arguments:**

| Argument | Type | Required | Description         |
| -------- | ---- | -------- | ------------------- |
| `id`     | ID!  | Yes      | Customer identifier |

## customers

List all customers in your organization.

```graphql theme={null}
query {
  customers(first: 20, after: "cursor_abc") {
    totalCount
    edges {
      node {
        id
        name
        email
        tier
      }
      cursor
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}
```

**Arguments:**

| Argument | Type   | Required | Description                                         |
| -------- | ------ | -------- | --------------------------------------------------- |
| `first`  | Int    | No       | Number of results to return (default: 20, max: 100) |
| `after`  | String | No       | Cursor for pagination                               |