Fairing Questions API
The Questions API from Fairing — 1 operation(s) for questions.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/fairing:fairing-questions-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: fairing-api Questions API
version: '1.0'
servers:
- url: https://app.fairing.co/api
security:
- sec0: []
tags:
- name: Questions
paths:
/questions:
get:
summary: List all questions
description: ''
operationId: retrieve-questions
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "{\n \"data\": [\n {\n \"allow_other\": true,\n \"customer_type\": \"everyone\",\n \"frequency_type\": \"once\",\n \"id\": 1818,\n \"inserted_at\": \"2021-07-06T14:49:37+00:00\",\n \"other_placeholder\": \"Other\",\n \"prompt\": \"One more thing: How did you hear about us?\",\n \"published_at\": \"2021-09-22T18:57:15+00:00\",\n \"randomize_responses\": false,\n \"responses\": [\n {\n \"clarification_question\": {\n \"allow_other\": true,\n \"id\": 1873,\n \"other_placeholder\": \"Other\",\n \"prompt\": \"Who told you?\",\n \"randomize_responses\": true,\n \"responses\": [\n {\n \"id\": 11834,\n \"value\": \"A friend\"\n },\n {\n \"id\": 11835,\n \"value\": \"A family member\"\n }\n ],\n \"type\": \"single_response\"\n },\n \"id\": 11379,\n \"value\": \"From a friend or family member (has clarification)\"\n },\n {\n \"clarification_question\": null,\n \"id\": 11381,\n \"value\": \"Online Article\"\n },\n {\n \"clarification_question\": {\n \"allow_other\": true,\n \"id\": 2137,\n \"other_placeholder\": null,\n \"prompt\": \"Who is the influencer? \",\n \"randomize_responses\": true,\n \"responses\": [],\n \"type\": \"open_ended\"\n },\n \"id\": 11410,\n \"value\": \"Was it an influencer? \"\n }\n ],\n \"submit_text\": \"Submit\",\n \"type\": \"single_response\",\n \"updated_at\": \"2022-01-07T14:58:01+00:00\"\n },\n {\n \"allow_other\": true,\n \"customer_type\": \"everyone\",\n \"frequency_type\": \"always\",\n \"id\": 33,\n \"inserted_at\": \"2021-05-07T19:14:25+00:00\",\n \"other_placeholder\": null,\n \"prompt\": \"What kind of car do you drive?\",\n \"published_at\": \"2022-02-15T15:39:52+00:00\",\n \"randomize_responses\": true,\n \"responses\": [],\n \"submit_text\": \"Submit\",\n \"type\": \"open_ended\",\n \"updated_at\": \"2022-02-15T15:39:52+00:00\"\n },\n {\n \"allow_other\": true,\n \"customer_type\": \"everyone\",\n \"frequency_type\": \"always\",\n \"id\": 12,\n \"inserted_at\": \"2021-04-20T19:31:04+00:00\",\n \"other_placeholder\": \"Other\",\n \"prompt\": \"Do you own or pay for any of the following?\",\n \"published_at\": \"2022-02-15T15:39:53+00:00\",\n \"randomize_responses\": true,\n \"responses\": [\n {\n \"clarification_question\": null,\n \"id\": 11763,\n \"value\": \"Gym Membership\"\n },\n {\n \"clarification_question\": null,\n \"id\": 11784,\n \"value\": \"Peloton\"\n },\n {\n \"clarification_question\": null,\n \"id\": 11785,\n \"value\": \"Mirror\"\n },\n {\n \"clarification_question\": null,\n \"id\": 11787,\n \"value\": \"Tonal\"\n }\n ],\n \"submit_text\": \"Submit\",\n \"type\": \"multi_response\",\n \"updated_at\": \"2022-02-15T15:39:53+00:00\"\n }\n ]\n}"
Result with targeting data (include_targeting=true):
summary: Result with targeting data (include_targeting=true)
value:
data:
- allow_other: true
customer_type: everyone
frequency_type: once
id: 1818
inserted_at: '2021-07-06T14:49:37+00:00'
other_placeholder: Other
prompt: 'One more thing: How did you hear about us?'
published_at: '2021-09-22T18:57:15+00:00'
randomize_responses: false
responses:
- clarification_question:
allow_other: true
id: 1873
other_placeholder: Other
prompt: Who told you?
randomize_responses: true
responses:
- id: 11834
value: A friend
- id: 11835
value: A family member
type: single_response
id: 11379
value: From a friend or family member (has clarification)
- clarification_question: null
id: 11381
value: Online Article
- clarification_question:
allow_other: true
id: 2137
other_placeholder: null
prompt: 'Who is the influencer? '
randomize_responses: true
responses: []
type: open_ended
id: 11410
value: 'Was it an influencer? '
submit_text: Submit
targeting:
surfaces:
- post_purchase
geo_targeting:
option: include
targets:
US: all
CA:
- 'ON'
- QC
product_targeting: null
type: single_response
updated_at: '2022-01-07T14:58:01+00:00'
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
allow_other:
type: boolean
example: true
default: true
customer_type:
type: string
example: everyone
frequency_type:
type: string
example: once
id:
type: integer
example: 1818
default: 0
inserted_at:
type: string
example: '2021-07-06T14:49:37+00:00'
other_placeholder:
type: string
example: Other
prompt:
type: string
example: 'One more thing: How did you hear about us?'
published_at:
type: string
example: '2021-09-22T18:57:15+00:00'
randomize_responses:
type: boolean
example: false
default: true
responses:
type: array
items:
type: object
properties:
clarification_question:
type: object
properties:
allow_other:
type: boolean
example: true
default: true
id:
type: integer
example: 1873
default: 0
other_placeholder:
type: string
example: Other
prompt:
type: string
example: Who told you?
randomize_responses:
type: boolean
example: true
default: true
responses:
type: array
items:
type: object
properties:
id:
type: integer
example: 11834
default: 0
value:
type: string
example: A friend
type:
type: string
example: single_response
id:
type: integer
example: 11379
default: 0
value:
type: string
example: From a friend or family member (has clarification)
submit_text:
type: string
example: Submit
type:
type: string
example: single_response
updated_at:
type: string
example: '2022-01-07T14:58:01+00:00'
targeting:
type: object
properties:
surfaces:
type: array
items:
type: string
description: The Shopify platform surfaces on which the question is shown. Common values include shopify_checkout, post_purchase, and thank_you_page. null when no surfaces are configured.
geo_targeting:
type: object
properties:
option:
type: string
description: Whether the listed regions are included or excluded by the rule.
enum:
- include
- exclude
targets:
type: object
properties: {}
description: A map of ISO 3166-1 alpha-2 country codes (for example, US, CA, GB) to the targeted regions within that country. The value for each country is either the string "all" (the entire country is targeted) or an array of subdivision codes for that country (for example, ["ON", "QC"] for Ontario and Quebec).
description: The geographic targeting rule for the question. null when no geographic targeting is configured.
product_targeting:
type: object
properties:
option:
type: string
enum:
- include
- exclude
description: Whether the listed products are included or excluded by the rule.
product_ids:
type: array
items:
type: integer
description: The Shopify product IDs targeted by the rule.
description: The product targeting rule for the question. null when no product targeting is configured.
description: The targeting configuration for the question. Only present when the request includes the query parameter include_targeting=true. Each sub-section is independently configurable; sections that are not configured are returned as ``null`` so the overall shape is stable.
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
parameters:
- in: query
name: include_targeting
schema:
type: boolean
default: 'false'
description: When set to the string true, each question in the response includes a targeting object describing the surfaces, geographic targeting, and product targeting configured for that question. Defaults to false; any value other than the literal string true is treated as false.
required: false
tags:
- Questions
components:
securitySchemes:
sec0:
type: apiKey
in: header
name: Authorization
x-readme-fauxas: true
x-provenance:
method: searched
source: https://docs.fairing.co/reference
harvested: '2026-10-29'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://docs.fairing.co/reference/create-sources.md
- https://docs.fairing.co/reference/retrieve-questions.md
- https://docs.fairing.co/reference/retrieve-responses.md
merge:
pages: 3
deduped: 2
conflicts_kept_first: 0