Fairing Responses API
The Responses API from Fairing — 1 operation(s) for responses.
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-responses-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 Responses API
version: '1.0'
servers:
- url: https://app.fairing.co/api
security:
- sec0: []
tags:
- name: Responses
paths:
/responses:
get:
summary: List all responses
description: ''
operationId: retrieve-responses
parameters:
- name: starting_after
in: query
description: Response ID, used as a cursor in pagination. Use this to fetch the page **after** the response in the active sort direction.
schema:
type: string
- name: ending_before
in: query
description: Response ID, used as a cursor in pagination. Use this to fetch the page **before** the response in the active sort direction. Mutually exclusive with `starting_after`.
schema:
type: string
- name: inserted_at_min
in: query
description: ISO 8601 UTC timestamp. Returns responses inserted at or after this time.
schema:
type: string
format: date-time
- name: inserted_at_max
in: query
description: ISO 8601 UTC timestamp. Returns responses inserted at or before this time.
schema:
type: string
format: date-time
- name: updated_at_min
in: query
description: ISO 8601 UTC timestamp. Returns responses last updated at or after this time.
schema:
type: string
format: date-time
- name: updated_at_max
in: query
description: ISO 8601 UTC timestamp. Returns responses last updated at or before this time.
schema:
type: string
format: date-time
- name: sort
in: query
description: Result ordering. Defaults to `inserted_at_desc` (newest first).
schema:
type: string
enum:
- inserted_at_desc
- inserted_at_asc
- updated_at_desc
- updated_at_asc
default: inserted_at_desc
- name: limit
in: query
description: The number of responses to fetch per request. Defaults to 100, maximum is 1000.
schema:
type: integer
format: int32
default: 100
- name: question_id
in: query
description: If supplied, only responses for the given question are returned.
schema:
type: integer
format: int32
- name: since
in: query
description: '**Legacy alias for `inserted_at_min`.** Still accepted for backwards compatibility; prefer the canonical name.'
schema:
type: string
format: date-time
- name: until
in: query
description: '**Legacy alias for `inserted_at_max`.** Still accepted for backwards compatibility; prefer the canonical name.'
schema:
type: string
format: date-time
- name: after
in: query
description: '**Legacy alias for `starting_after`.** Still accepted for backwards compatibility; prefer the canonical name.'
schema:
type: string
- name: before
in: query
description: '**Legacy alias for `ending_before`.** Still accepted for backwards compatibility; prefer the canonical name.'
schema:
type: string
responses:
'200':
description: '200'
content:
application/json:
examples:
Success:
value: "{\n \"data\":[\n {\n \"available_responses\":null,\n \"clarification_question\":false,\n \"coupon_amount\":null,\n \"coupon_code\":null,\n \"coupon_type\":null,\n \"customer_id\":\"3445695217710\",\n \"customer_order_count\":17,\n \"email\":\"user@example.com\",\n \"id\":\"ENz45Kvbxru0B5X6kDN7Y\",\n \"inserted_at\":\"2022-02-16T17:54:35+00:00\",\n \"landing_page_path\":null,\n \"order_currency_code\":\"USD\",\n \"order_id\":\"4104320450606\",\n \"order_number\":\"1301\",\n \"order_platform\":\"shopify\",\n \"order_source\":\"shopify_checkout\",\n \"order_total\":\"57.71\",\n \"order_total_usd\":\"57.71\",\n \"other\":false,\n \"other_response\":null,\n \"question\":\"Who is your favorite co-founder?\",\n \"question_id\":11,\n \"question_type\":\"single_response\",\n \"referring_question\":null,\n \"referring_question_id\":null,\n \"referring_question_response\":null,\n \"referring_question_response_id\":null,\n \"referring_site\":\"null\",\n \"response\":\"Somebody Else\",\n \"response_id\":11747,\n \"response_position\":1,\n \"response_provided_at\":\"2022-02-16T17:54:34Z\",\n \"submit_delta\":9428,\n \"updated_at\":\"2022-02-16T17:54:35+00:00\",\n \"utm_campaign\":null,\n \"utm_content\":null,\n \"utm_medium\":null,\n \"utm_source\":null,\n \"utm_term\":null\n },\n {\n \"available_responses\":null,\n \"clarification_question\":true,\n \"coupon_amount\":null,\n \"coupon_code\":null,\n \"coupon_type\":null,\n \"customer_id\":\"3446081224750\",\n \"customer_order_count\":10,\n \"email\":\"user_one@example.com\",\n \"id\":\"pk9ZDChjMNueWHZqHEF5Z\",\n \"inserted_at\":\"2021-07-09T18:35:57+00:00\",\n \"landing_page_path\":null,\n \"order_currency_code\":null,\n \"order_id\":\"3821070549038\",\n \"order_number\":\"1260\",\n \"order_platform\":null,\n \"order_source\":null,\n \"order_total\":null,\n \"order_total_usd\":null,\n \"other\":false,\n \"other_response\":null,\n \"question\":\"Which one?\",\n \"question_id\":2138,\n \"question_type\":\"single_response\",\n \"referring_question\":\"How did you hear about us?\",\n \"referring_question_id\":9,\n \"referring_question_response\":\"Online Ad\",\n \"referring_question_response_id\":11733,\n \"referring_site\":null,\n \"response\":\"Facebook\",\n \"response_id\":11734,\n \"response_position\":1,\n \"response_provided_at\":\"2021-07-09T18:35:57Z\",\n \"submit_delta\":1884,\n \"updated_at\":\"2021-07-09T18:35:57+00:00\",\n \"utm_campaign\":null,\n \"utm_content\":null,\n \"utm_medium\":null,\n \"utm_source\":null,\n \"utm_term\":null\n }\n ],\n \"next\":\"https://app.fairing.co/api/responses?starting_after=pk9ZDChjMNueWHZqHEF5Z\",\n \"prev\":\"https://app.fairing.co/api/responses?ending_before=ENz45Kvbxru0B5X6kDN7Y\"\n}"
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
available_responses: {}
clarification_question:
type: boolean
example: false
default: true
coupon_amount: {}
coupon_code: {}
coupon_type: {}
customer_id:
type: string
example: '3445695217710'
customer_order_count:
type: integer
example: 17
default: 0
email:
type: string
example: user@example.com
id:
type: string
example: ENz45Kvbxru0B5X6kDN7Y
inserted_at:
type: string
example: '2022-02-16T17:54:35+00:00'
landing_page_path: {}
order_currency_code:
type: string
example: USD
order_id:
type: string
example: '4104320450606'
order_number:
type: string
example: '1301'
order_platform:
type: string
example: shopify
order_source:
type: string
example: shopify_checkout
order_total:
type: string
example: '57.71'
order_total_usd:
type: string
example: '57.71'
other:
type: boolean
example: false
default: true
other_response: {}
question:
type: string
example: Who is your favorite co-founder?
question_id:
type: integer
example: 11
default: 0
question_type:
type: string
example: single_response
referring_question: {}
referring_question_id: {}
referring_question_response: {}
referring_question_response_id: {}
referring_site:
type: string
example: 'null'
response:
type: string
example: Somebody Else
response_id:
type: integer
example: 11747
default: 0
response_position:
type: integer
example: 1
default: 0
response_provided_at:
type: string
example: '2022-02-16T17:54:34Z'
submit_delta:
type: integer
example: 9428
default: 0
updated_at:
type: string
example: '2022-02-16T17:54:35+00:00'
utm_campaign: {}
utm_content: {}
utm_medium: {}
utm_source: {}
utm_term: {}
next:
type: string
example: https://app.fairing.co/api/responses?starting_after=pk9ZDChjMNueWHZqHEF5Z
prev:
type: string
example: https://app.fairing.co/api/responses?ending_before=ENz45Kvbxru0B5X6kDN7Y
'401':
description: '401'
content:
application/json:
examples:
Result:
value: "{\n \"message\": \"Unauthorized\",\n \"status\": 401\n}"
schema:
type: object
properties:
message:
type: string
example: Unauthorized
status:
type: integer
example: 401
default: 0
'404':
description: '404'
content:
application/json:
examples:
Result:
value: "{\n \"message\": \"Not found\",\n \"status\": 404\n}"
schema:
type: object
properties:
message:
type: string
example: Not found
status:
type: integer
example: 404
default: 0
deprecated: false
tags:
- Responses
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