> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blnkfinance.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Filter identities
> Filter identities with structured query filters using the Go SDK.
export const CtaCallout = props => {
const {title, buttonLabel, href, trackingEvent, buttonTarget, rel = "noopener noreferrer", children} = props;
const handleCtaClick = () => {
if (typeof window === "undefined" || !trackingEvent) {
return;
}
try {
window.dispatchEvent(new CustomEvent("blnk:docs-cta", {
detail: {
name: trackingEvent,
href
}
}));
} catch {}
try {
window.posthog?.capture?.(trackingEvent, {
href
});
} catch {}
const gaPayload = {
cta_href: href
};
try {
window.gtag?.("event", trackingEvent, gaPayload);
} catch {}
try {
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
event: trackingEvent,
...gaPayload
});
} catch {}
};
const isExternal = typeof href === "string" && (/^https?:\/\//i).test(href);
const target = buttonTarget ?? (isExternal ? "_blank" : undefined);
const linkRel = isExternal ? rel : undefined;
return ;
};
Use `client.Identity.Filter` to query [identities](/identities/introduction) with structured filters.
The Go SDK exposes `Filter` on each service rather than a unified `Search.filter` helper. Use `client.Identity.Filter` for identities, and see [filter records](/sdks/go/search/search-db) for other collections.
```go client.Identity.Filter theme={"system"}
result, resp, err := client.Identity.Filter(
blnkgo.FilterParams{
Filters: []blnkgo.Filter{
{
Field: "email_address",
Operator: blnkgo.OpEqual,
Value: "john.doe@example.com",
},
{
Field: "category",
Operator: blnkgo.OpEqual,
Value: "customer",
},
},
Limit: 20,
Offset: 0,
IncludeCount: true,
},
)
```
| Field | Type | Description |
| :------------- | :---------------- | :-------------------------------------------------------------------------------------- |
| `Filters` | `[]blnkgo.Filter` | Array of filter conditions, each with a `Field`, `Operator`, and a `Value` or `Values`. |
| `SortBy` | `string` | Field to sort by. Defaults to `created_at`. |
| `SortOrder` | `string` | Sort direction, `asc` or `desc`. Defaults to `desc`. |
| `IncludeCount` | `bool` | Return `TotalCount` in the response. Defaults to `false`. |
| `Limit` | `int` | Maximum records to return. Defaults to 20, max 100. |
| `Offset` | `int` | Records to skip for pagination. Defaults to 0. |
Read `result.Data` for matching identities. Use `result.TotalCount` with `Limit` and `Offset` to paginate when `IncludeCount` is `true`.
```json 200 OK wrap theme={"system"}
{
"data": [
{
"identity_id": "idt_3b63c8da-af29-4cc3-ad38-df17d87456e6",
"identity_type": "individual",
"first_name": "John",
"last_name": "Doe",
"email_address": "john.doe@example.com",
"category": "customer",
"created_at": "2024-11-26T08:36:36.238244338Z"
}
],
"total_count": 1
}
```
| Field | Type | Description |
| :------------ | :--------- | :------------------------------------------------------------------ |
| `data` | `object[]` | Array of matching identity records. |
| `total_count` | `number` | Total matching records. Only present when `IncludeCount` is `true`. |
***
## Related docs
Linking balances and handling profile data.
Supported operators and field reference.
***
## Need help?
We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool.
To ask questions or discuss issues, please [contact us](mailto:support@blnkfinance.com) or [join our Discord community](https://discord.gg/7WNv94zPpx).
Sign up and manage your ledger with our back-office dashboard. You can invite teammates to collaborate and manage your ledger operations directly from the dashboard.