> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.a1.uk.astutepayroll.in/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.a1.uk.astutepayroll.in/_mcp/server.

# The Include Parameter

> How to use the include query parameter to filter response fields

All endpoints support an optional `include` query parameter that controls which fields are returned in the response. When provided, only the specified fields are included instead of the full object — useful for reducing payload size when you only need a subset of data.

## Usage

`include` accepts a comma-separated list of field paths. Nested paths are supported using dot notation.

```
include=firstName,lastName,emailAddress
include=firstName,contact.phone,contact.mobile.number
```

## Example

Retrieve only the name and email of a customer:

```bash
curl -X GET "https://api.astutepayroll.com/customers/45b0d09b-bc25-4b45-af21-dc15cba56ce2?include=entityName,email" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "x-tenant-id: YOUR_TENANT_ID"
```

```json
{
  "entityName": "Acme Corp",
  "email": "billing@acme.com"
}
```

> **Info**
>
> When `include` is omitted, the full object is returned.