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

# Response Trimming

> Reduce token usage by 40-80% with fields and format parameters.

# Response Trimming

Reduce token usage by 40-80% with two parameters available on all curated tools.

## Parameters

### `fields` — Select specific fields

Use dot-notation to pick only the fields you need:

```json theme={null}
{"fields": ["id", "properties.email", "properties.firstname"]}
```

This works on any response shape — the gateway intelligently applies field picking to array items inside `results`, `records`, or `rows` containers.

### `format` — Strip metadata

| Value            | Behavior                                                                |
| ---------------- | ----------------------------------------------------------------------- |
| `full` (default) | Returns the complete executor wrapper: `{success, status, data: {...}}` |
| `compact`        | Strips the wrapper, returns the data payload directly                   |

## Examples

### Full response (default)

```json theme={null}
{
  "success": true,
  "status": 200,
  "data": {
    "results": [
      {"id": "1", "properties": {"email": "a@b.com", "firstname": "Alice", "phone": "555-1234", "createdate": "2025-01-01"}}
    ],
    "paging": {"next": {"after": "2"}}
  }
}
```

### With `format: "compact"`

```json theme={null}
{
  "results": [
    {"id": "1", "properties": {"email": "a@b.com", "firstname": "Alice", "phone": "555-1234", "createdate": "2025-01-01"}}
  ],
  "paging": {"next": {"after": "2"}}
}
```

### With `fields: ["id", "properties.email"]`

```json theme={null}
{
  "success": true,
  "status": 200,
  "data": {
    "results": [{"id": "1", "properties": {"email": "a@b.com"}}],
    "paging": {"next": {"after": "2"}}
  }
}
```

### Both combined

```json theme={null}
{
  "results": [{"id": "1", "properties": {"email": "a@b.com"}}],
  "paging": {"next": {"after": "2"}}
}
```

## Provider-specific behavior

| Provider   | Compact extracts                     |
| ---------- | ------------------------------------ |
| HubSpot    | `{results, paging}`                  |
| Salesforce | `{records, totalSize, done}`         |
| GA4        | `rows` array                         |
| Google Ads | First result set's `results` array   |
| Others     | `data` payload from executor wrapper |