Contents
On this page

Get Attempts Summary - Plugixa Exam

GET /plugixa-exam/v1/attempts/summary

Read the totals behind the attempts dashboard: how many attempts there are, how many need marking, the pass rate, the average score and the submissions of the last 14 days.

Scope attempts:read; the token’s user needs the attempts:view permission.

The figures are site-wide, across every exam. There are no parameters.

Request

GET https://your-site.example/wp-json/plugixa-exam/v1/attempts/summary

Responses

200 OK. data is the summary.

{
  "success": true,
  "data": {
    "total": 412,
    "in_progress": 6,
    "needs_grading": 9,
    "marked": 380,
    "passed": 297,
    "pass_rate": 78.2,
    "average_percent": 71.4,
    "trend": [
      { "date": "2026-10-30", "count": 12 },
      { "date": "2026-10-31", "count": 0 },
      { "date": "2026-11-12", "count": 18 }
    ]
  }
}

The trend above is shortened; the real list has one entry per day for the last 14 days.

Field Type Meaning
data.total integer All attempts
data.in_progress integer Attempts still being taken
data.needs_grading integer Attempts waiting for a marker
data.marked integer Attempts that have a percentage
data.passed integer Marked attempts that passed
data.pass_rate number|null passed as a percentage of marked, to 1 decimal. null when nothing is marked yet
data.average_percent number|null Average percentage of the marked attempts, to 1 decimal. null when nothing is marked yet
data.trend object[] Submissions per day over the last 14 days, oldest first
data.trend[].date string The day, YYYY-MM-DD, in UTC
data.trend[].count integer Attempts submitted that day

Errors

Plus the errors every endpoint can return.

Examples

curl -s "https://your-site.example/wp-json/plugixa-exam/v1/attempts/summary" \
  -H "Authorization: Bearer $PLUGIXA_EXAM_TOKEN"

<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-exam/v1/attempts/summary');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('PLUGIXA_EXAM_TOKEN'),
    ],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

const response = await fetch('https://your-site.example/wp-json/plugixa-exam/v1/attempts/summary', {
  headers: {
    'Authorization': `Bearer ${process.env.PLUGIXA_EXAM_TOKEN}`,
  },
});
const { data } = await response.json();

Quick Links

Share