Skip to main content
GET
/
focus-groups
/
{id}
cURL
curl https://app.mavera.io/api/v1/focus-groups/YOUR_FOCUS_GROUP_ID \
  -H "Authorization: Bearer mvra_live_your_key_here"
{
  "id": "<string>",
  "object": "focus_group",
  "status": "<string>",
  "created_at": 123,
  "updated_at": 123,
  "name": "<string>",
  "sample_size": 123,
  "personas": [
    {
      "id": "<string>",
      "name": "<string>",
      "category": "<string>",
      "description": "<string>"
    }
  ],
  "questions": [
    {
      "question": "How likely are you to recommend this product to a friend?",
      "type": "net_promoter_score",
      "options": [
        "Very Satisfied",
        "Satisfied",
        "Neutral",
        "Dissatisfied"
      ],
      "config": {
        "min_value": 123,
        "max_value": 123,
        "min_label": "<string>",
        "max_label": "<string>",
        "likert_labels": [
          "<string>"
        ],
        "left_label": "<string>",
        "right_label": "<string>",
        "scale_points": 123,
        "matrix_rows": [
          "<string>"
        ],
        "matrix_columns": [
          "<string>"
        ],
        "attributes": [
          "<string>"
        ],
        "rating_scale": 123,
        "max_length": 123
      },
      "description": "<string>",
      "is_required": true
    }
  ],
  "error": "<string>",
  "summary": {
    "total_personas": 123,
    "total_questions": 123,
    "sample_size": 123,
    "total_responses": 123,
    "total_data_points": 123,
    "completed_at": 123
  },
  "progress": {
    "expected_results": 123,
    "completed_results": 123,
    "percentage": 123
  },
  "results": [
    {
      "question_id": "<string>",
      "question": "<string>",
      "type": "<string>",
      "responses": [
        {
          "persona": {
            "id": "<string>",
            "name": "<string>"
          },
          "data": {}
        }
      ]
    }
  ]
}

Authorizations

Authorization
string
header
required

API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.

Path Parameters

id
string
required

The focus group ID.

Response

Focus group details with results if completed.

id
string
object
enum<string>
Available options:
focus_group
status
string
created_at
integer
updated_at
integer
name
string
sample_size
integer
personas
object[]
questions
object[]
error
string | null
summary
object

Summary metrics (only when status is completed).

progress
object

Progress info (only when status is generating).

results
object[]

Full results grouped by question (only when status is completed).