List your feedback

Written and maintained by The ProspectAPIs team

GET/v1/feedback

GET /v1/feedback is the ProspectAPIs operation listFeedback, in the Account group of the REST API. The reports this account sent with POST /v1/feedback (any of its keys), newest first, each with its status and the team's response. Free. Cost: free. Send your API key as a Bearer token in the Authorization header.

The quickstart shows this call in context, next to the first requests most integrations make.

Parameters

Parameters of GET /v1/feedback
Name	In	Type	Description
limit	query	integer	Page size, 1 to 100 (default 25).
cursor	query	string	The previous page's next_cursor, passed back unchanged.

An unknown query parameter is refused with a 400 rather than ignored, so a typo never widens a search you pay for.

Responses

Response codes of GET /v1/feedback
Status	Meaning
200	A page of this account's reports.
400	The request was invalid (e.g. a bad filter or input); nothing was charged.
401	The API key is missing or invalid.
429	Too many requests; retry after the window.

Every error answers with the same JSON body, an error string and sometimes a code; the errors page lists each status and when it happens. A per-key 429 carries Retry-After; see rate limits.

200 response fields

A page of this account's reports. The body is a FeedbackList.

Fields of the 200 response
Field	Type	Description
data required	array of Feedback
data[].id required	string (uuid)	The feedback_id POST /v1/feedback returned.
data[].kind required	string: bug, feature, question
data[].tool required	string or null	The tool or endpoint the report is about, when one was named.
data[].title required	string
data[].details required	string
data[].status required	string: received, triaged, fixed, wont_fix, needs_info	received: not looked at yet. triaged: the team is on it. fixed: shipped. wont_fix: not planned (the response says why). needs_info: the team needs more from you (see response).
data[].response required	string or null	The team's reply, when there is one.
data[].responded_at required	string (date-time) or null
data[].created_at required	string (date-time)
data[].updated_at required	string (date-time)	The last change to status or response.
data[].from_this_key required	boolean	true when the API key making this call sent the report; another key of the same account reads it too.
next_cursor required	string or null	Pass back as cursor for the next page; null on the last page.
count required	integer

Response headers
Header	Meaning
RateLimit-Limit	Requests this API key may make per minute.
RateLimit-Remaining	Requests left in the current one-minute window.
RateLimit-Reset	Seconds until the current window resets.

Code samples

Each sample sends the same request. Set PROSPECTAPIS_KEY in your environment first. Values come from the spec's examples; replace them with your own.

curl

curl -G https://api.prospectapis.com/v1/feedback \
  -H "Authorization: Bearer $PROSPECTAPIS_KEY" \
  --data-urlencode "limit=10"

JavaScript (fetch)

const params = new URLSearchParams({ limit: "10" });
const res = await fetch(`https://api.prospectapis.com/v1/feedback?${params}`, {
  headers: { Authorization: `Bearer ${process.env.PROSPECTAPIS_KEY}` },
});
if (!res.ok) throw new Error(`${res.status}: ${(await res.json().catch(() => ({}))).error ?? res.statusText}`);
const data = await res.json();
console.log(data);

Python (requests)

import os, requests

res = requests.get(
    "https://api.prospectapis.com/v1/feedback",
    headers={"Authorization": f"Bearer {os.environ['PROSPECTAPIS_KEY']}"},
    params={"limit": 10},
    timeout=30,
)
res.raise_for_status()
data = res.json()
print(data)

Billing

This call is free: it never spends credits, so you can call it as often as the rate limit allows. Metered calls on the same key report your balance after each response in X-Credits-Remaining, and GET /v1/account shows it at any time.

Previous operation: Account balance. Next operation: Send feedback. Every operation, grouped by area, is on the API reference index.

Create a free account to get a key, then run the samples above with your own values.

Was this page helpful?