---
canonical_url: "https://docs.composio.dev/toolkits/fairing"
markdown_url: "https://docs.composio.dev/toolkits/fairing.md"
product: "platform"
version: null
last_updated: null
---

# Fairing

Fairing provides post-purchase attribution surveys, question management, and response data for measuring marketing performance.

- **Category:** forms & surveys
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 2
- **Triggers:** 0
- **Slug:** `FAIRING`
- **Version:** 00000000_00

## Tools

### List Questions

**Slug:** `FAIRING_LIST_QUESTIONS`

Return the connected shop's complete Fairing question stream, optionally including targeting rules.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `include_targeting` | boolean | No | Whether to include each question's surface, geographic, and product targeting configuration. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Responses

**Slug:** `FAIRING_LIST_RESPONSES`

Return one page of the connected shop's survey responses, with optional question, time-window, and sort filters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("inserted_at_desc" | "inserted_at_asc" | "updated_at_desc" | "updated_at_asc") | No | Field and direction used to order the response page. |
| `limit` | integer | No | Maximum responses to return in this page (1-1000). |
| `next_cursor` | string | No | Continuation cursor returned by a previous call. Omit for the first page and pass it back unchanged to fetch the next page. |
| `question_id` | integer | No | Only return responses for this Fairing question ID. |
| `updated_at_max` | string | No | Inclusive ISO 8601 upper bound on when responses were last updated. |
| `updated_at_min` | string | No | Inclusive ISO 8601 lower bound on when responses were last updated. |
| `inserted_at_max` | string | No | Inclusive ISO 8601 upper bound on when responses were inserted. |
| `inserted_at_min` | string | No | Inclusive ISO 8601 lower bound on when responses were inserted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |