API reference / Account

Send feedback

Written and maintained by The ProspectAPIs team

POST/v1/feedback

POST /v1/feedback is the ProspectAPIs operation sendFeedback, in the Account group of the REST API. Report a bug, a wrong or empty field, or a missing capability to the team. Free; at most 10 an hour per account. Cost: free, 10 an hour. 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

This operation takes no path or query parameters.

Request body

JSON (FeedbackRequest).

{
  "kind": "bug",
  "title": "country filter ignores accents",
  "details": "GET /v1/funding?country=Curaçao returned 0 records; expected 2."
}

Responses

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.

202 response fields

The report was sent to the team. The body is a FeedbackAccepted.

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 -X POST https://api.prospectapis.com/v1/feedback \
  -H "Authorization: Bearer $PROSPECTAPIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "kind": "bug", "title": "country filter ignores accents", "details": "GET /v1/funding?country=Curaçao returned 0 records; expected 2." }'

const res = await fetch("https://api.prospectapis.com/v1/feedback", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PROSPECTAPIS_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "kind": "bug",
    "title": "country filter ignores accents",
    "details": "GET /v1/funding?country=Curaçao returned 0 records; expected 2."
  }),
});
if (!res.ok) throw new Error(`${res.status}: ${(await res.json().catch(() => ({}))).error ?? res.statusText}`);
const data = await res.json();
console.log(data);

import os, requests

res = requests.post(
    "https://api.prospectapis.com/v1/feedback",
    headers={"Authorization": f"Bearer {os.environ['PROSPECTAPIS_KEY']}"},
    json={
        "kind": "bug",
        "title": "country filter ignores accents",
        "details": "GET /v1/funding?country=Curaçao returned 0 records; expected 2.",
    },
    timeout=30,
)
res.raise_for_status()
data = res.json()
print(data)

Billing

This call is free: it never spends credits or free records, 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.

Related

Previous operation: Account balance. Next operation: API version. 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 (this call acts for real, so use real inputs).