> ## 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.

# Customer

> The Customer type represents an organization using the Hey Chocolate platform.

## Customer type

```graphql theme={null}
type Customer {
  id: ID!
  name: String!
  email: String!
  organization: Organization!
  tier: Tier!
  apiKeys: [ApiKey!]!
  webhookUrl: String
  products: ProductConnection!
  orders: OrderConnection!
  impactProfile: CustomerImpactProfile
  createdAt: DateTime!
  updatedAt: DateTime!
}

type Organization {
  id: ID!
  name: String!
  tier: Tier!
  apiQuota: ApiQuota!
  members: [Customer!]!
}

type ApiQuota {
  requestsPerMinute: Int!
  calculationsPerDay: Int!
  assetRendersPerDay: Int!
  used: ApiQuotaUsage!
}

type ApiQuotaUsage {
  requests: Int!
  calculations: Int!
  assetRenders: Int!
  resetAt: DateTime!
}

type ApiKey {
  id: ID!
  prefix: String!
  label: String
  permissions: [String!]!
  createdAt: DateTime!
  lastUsedAt: DateTime
}

enum Tier {
  FREE
  GROWTH
  ENTERPRISE
}
```

## Fields

| Field           | Type                  | Description                                        |
| --------------- | --------------------- | -------------------------------------------------- |
| `id`            | ID!                   | Unique customer identifier                         |
| `name`          | String!               | Customer display name                              |
| `email`         | String!               | Primary email address                              |
| `organization`  | Organization!         | Parent organization                                |
| `tier`          | Tier!                 | Subscription tier (`FREE`, `GROWTH`, `ENTERPRISE`) |
| `apiKeys`       | \[ApiKey!]!           | API keys associated with this customer             |
| `webhookUrl`    | String                | Default webhook delivery URL                       |
| `products`      | ProductConnection!    | Products owned by this customer                    |
| `orders`        | OrderConnection!      | Orders placed by this customer                     |
| `impactProfile` | CustomerImpactProfile | Gamification profile with badges and milestones    |
| `createdAt`     | DateTime!             | Account creation timestamp                         |
| `updatedAt`     | DateTime!             | Last update timestamp                              |

## Example query

```graphql theme={null}
query {
  me {
    id
    name
    organization {
      name
      tier
      apiQuota {
        requestsPerMinute
        calculationsPerDay
        used { requests calculations }
      }
    }
    products(first: 5) {
      totalCount
      edges { node { id name } }
    }
  }
}
```