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

# DPP

> Query Digital Product Passports.

## dpp

Retrieve a Digital Product Passport by ID.

```graphql theme={null}
query {
  dpp(id: "dpp_xyz789") {
    id
    publicUrl
    qrCodeUrl
    status
    locale
    product { id name }
    sections {
      name
      fields { key value unit }
    }
    auditTrail {
      timestamp
      action
      actor
    }
    createdAt
    updatedAt
  }
}
```

**Arguments:**

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

## dppByProduct

Retrieve the DPP for a specific product.

```graphql theme={null}
query {
  dppByProduct(productId: "prod_abc123") {
    id
    publicUrl
    qrCodeUrl
    status
    sections {
      name
      fields { key value unit }
    }
  }
}
```

**Arguments:**

| Argument    | Type | Required | Description        |
| ----------- | ---- | -------- | ------------------ |
| `productId` | ID!  | Yes      | Product identifier |

## dpps

List all Digital Product Passports.

```graphql theme={null}
query {
  dpps(
    first: 20
    filter: { status: ACTIVE }
  ) {
    totalCount
    edges {
      node {
        id
        publicUrl
        status
        product { id name }
        createdAt
      }
      cursor
    }
    pageInfo { hasNextPage endCursor }
  }
}
```

**Arguments:**

| Argument | Type      | Required | Description                     |
| -------- | --------- | -------- | ------------------------------- |
| `first`  | Int       | No       | Results to return (default: 20) |
| `after`  | String    | No       | Cursor for pagination           |
| `filter` | DppFilter | No       | Filter by status                |