Submit a feasibility request

Server URLloading...

POST

/feasibility/requests

Send

Authorization

Body

Submit a feasibility request: can Terac source a panel for this task, and at what CPI (cost per participant).

This is an async request-reply. The response comes back immediately with status RECEIVED and no CPI (costPerParticipant is null). Terac prices it out of band, either automatically within seconds or by routing it to a person, so poll GET /feasibility/requests/{requestId} rather than assuming a turnaround.

Only what you send here is priced: taskDescription, panelDescription, and the count and timeline. The filters, screening questions and tasks on the opportunity you build later are not part of the brief that was priced, so a confirmed CPI applies to the scope described here and not to a materially different one.

Once RESPONDED, create the opportunity with POST /opportunities and pass feasibility_request_id to price it from that confirmed CPI (Terac skips the autonomous estimate), then launch it. The request stays RESPONDED until that study launches, and is closed as won at launch rather than at create.

Response Body

curl -X POST "https://terac.com/api/external/v2/feasibility/requests" \  -H "Content-Type: application/json" \  -d '{    "taskDescription": "A 30-minute written interview on a page we host: eight open questions about how the participant\'s team chose and rolled out its spend management software.",    "panelDescription": "Finance managers, senior managers and directors in the US or Canada who took part in choosing their company\'s current spend management software.",    "submissionCount": 12,    "timelineHours": 120,    "payRateFrequency": "ONE_TIME",    "loiMinutes": 30  }'

{
  "id": "tz4a98xxat96iws9zmbrgj3a",
  "status": "RECEIVED",
  "source": "API",
  "taskDescription": "A 30-minute written interview on a page we host: eight open questions about how the participant's team chose and rolled out its spend management software.",
  "panelDescription": "Finance managers, senior managers and directors in the US or Canada who took part in choosing their company's current spend management software.",
  "submissionCount": 12,
  "timelineHours": 120,
  "payRateFrequency": "ONE_TIME",
  "loiMinutes": 30,
  "costPerParticipant": null,
  "respondedAt": null,
  "createdAt": "2026-09-28T15:02:11.482Z",
  "dashboard_url": "https://terac.com/acme-research/feasibility"
}

{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "API key required. Include Authorization: Bearer <key> header."
  }
}

{
  "error": {
    "code": "FORBIDDEN",
    "message": "This account is not permitted to use the API."
  }
}

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Retry after 61 seconds."
  }
}

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}