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

# List Attributions

Get paginated attribution survey responses for a project. Filter by channel category, source, and time range.

<ParamField path="projectId" type="string" required>
  The project ID.
</ParamField>

<ParamField query="days" type="integer" default="30">
  Number of days to look back.
</ParamField>

<ParamField query="category" type="string">
  Filter by channel category: `ai_search`, `organic_search`, `paid`, `social`, `referral`, `content`, `direct`, `other`.
</ParamField>

<ParamField query="source" type="string">
  Filter by data source: `widget`, `hubspot`, `typeform`, `jotform`, `salesforce`, `api`, `api_bulk`.
</ParamField>

<ParamField query="page" type="integer" default="1">
  Page number.
</ParamField>

<ParamField query="limit" type="integer" default="50">
  Results per page (max 500).
</ParamField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl --request GET \
    --url 'https://api.finseo.ai/v1/projects/PROJECT_ID/attribution?days=30&category=ai_search' \
    --header 'Authorization: Bearer sk_live_xxxxxxxx'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={"system"}
  {
    "data": {
      "responses": [
        {
          "id": "a1b2c3d4-...",
          "channel_id": "ai_search",
          "channel_label": "AI Search (ChatGPT, Perplexity, etc.)",
          "channel_category": "ai_search",
          "respondent_email": "jane@company.com",
          "respondent_name": "Jane Smith",
          "deal_value": 12000,
          "deal_currency": "USD",
          "source": "hubspot",
          "page_url": "https://example.com/signup",
          "form_id": "lT4Z3j",
          "created_at": "2026-03-15T10:30:00Z"
        }
      ],
      "meta": {
        "page": 1,
        "limit": 50,
        "total": 142,
        "hasMore": true
      }
    }
  }
  ```
</ResponseExample>