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

> ## Agent Instructions
> For API operations, fetch https://gateway.firsttouch.ai/api/public/openapi.json for the complete input/output schemas, internal references, and x-mcp-annotations. Endpoint Markdown intentionally omits generated schema fragments. Select /api/public/tools/<tool_name> using the exact underscore-separated name. Send requests to https://gateway.firsttouch.ai; the canonical document currently omits servers. Start at https://docs.firsttouch.com/api-reference/agent-start.md.

# Get Contact Trace

> Return a compact cross-system trace for a supplied identities array of at most 10 items: Flow Plans where a matching contact is awaiting or enrolled, audience memberships, enrollments, and readable tasks.

<details>
<summary><strong>Detailed usage guidance</strong></summary>
<ul>
<li>For a selected contact, include every known supported identity as a separate array item: email, LinkedIn URL, phone, HubSpot contact id, and firstName, lastName, and companyDomain together when all three are known.</li>
<li>Do not choose only one known identity.</li>
<li>Each array item must contain exactly one direct identifier (email, LinkedIn URL, phone, or HubSpot contact id), or all of firstName, lastName, and companyDomain.</li>
<li>This tool searches every item and returns the union of matching records, not one canonical contact.</li>
<li>Every Flow Plan, audience, and enrollment includes matchedBy, showing the identity values that produced it.</li>
<li>Use find_contact_data first for name-only searches or multiple matches.</li>
<li>FirstTouch prospectId and enrollmentId are not accepted because they do not identify a contact across all trace sources.</li>
<li>Each enrollment, awaiting-candidate, and audience-contact lookup is capped at 50 rows per identity; notes warns when a source reaches that cap and the trace may be incomplete.</li>
<li>This is read-only and does not enrich, spend credits, or create an enrollment.</li>
</ul>
</details>



## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.firsttouch.com/llms.txt).