CorefinityCorefinityDocs
Open the Control PanelControl Panel
Performance audits · 9 of 14

Get an audit's report

Answers the report as the report preview of the Control Panel shows it: the comparison between your environments, each page's measurements and, when the audit has them, Google's scores and the Lighthouse comparison. These are today's figures, not the frozen ones a shared link shows.

GET/api/performance-audits/{audit}/report

Path parameters

auditintegerRequired

The id of an audit. Digits only. At least 1.

Returns

200 The report.

Fields of the 200 answer
built_atstringRequired

Format: date-time.

reportobjectRequired

The report's figures, as the report preview of the Control Panel shows them: today's, not the frozen ones a shared link shows.

Fields
auditobjectRequired

The audit's details.

Fields
companystring or nullRequired

The name of the audit's company.

created_atstring or nullRequired

Format: date-time.

idintegerRequired

At least 1.

namestringRequired
requests_per_measurementintegerRequired
run_atstring or nullRequired

When the measurements were saved. Like every time in a report, written with a +00:00 offset. Format: date-time.

server_locationstring or nullRequired

The name of the server location the pages were loaded from.

user_agentstringRequired
baselineobject or nullRequired

The environment the others are compared with: the first.

Fields
environmentstringRequired

The environment's name in the audit.

hoststringRequired
urlstringRequired
built_atstringRequired

Format: date-time.

comparisonsarray of objectsRequired

Each other environment against the baseline.

Fields of each item
environmentstringRequired

The environment's name in the audit.

excludedarray of objectsRequired

The page and cache state pairs left out of the figures, each with its reason.

Fields of each item
pagestringRequired
reasonstringRequired
statestringRequired
faster_onintegerRequired

The measurements this environment was faster on, out of of.

hoststringRequired
ofintegerRequired
summaryobject or nullRequired

The averages over the pages both environments measured, by cache state and overall. A part with nothing to compare is null.

Fields
cachedobject or null
Fields
baseline_avg_msnumberRequired
comparison_avg_msnumberRequired
diff_percentnumberRequired

Above zero when this environment is the faster one.

measurementsintegerRequired

The page and cache state pairs counted.

saved_msnumberRequired
speed_multipliernumber or nullRequired
overallobject or null
Fields
baseline_avg_msnumberRequired
comparison_avg_msnumberRequired
diff_percentnumberRequired

Above zero when this environment is the faster one.

measurementsintegerRequired

The page and cache state pairs counted.

saved_msnumberRequired
speed_multipliernumber or nullRequired
uncachedobject or null
Fields
baseline_avg_msnumberRequired
comparison_avg_msnumberRequired
diff_percentnumberRequired

Above zero when this environment is the faster one.

measurementsintegerRequired

The page and cache state pairs counted.

saved_msnumberRequired
speed_multipliernumber or nullRequired
urlstringRequired
coverageobjectRequired

What the results hold, which decides the sections a report can show.

lighthouseobject or nullRequired

The Lighthouse comparison, when the audit has one. Never the raw Lighthouse result.

lighthouse_failureobject or nullRequired

Why the last Lighthouse comparison did not complete. Null unless lighthouse_state is failed.

Fields
codestringRequired

connection (the Lighthouse service could not be reached), refused (it refused the request), upstream (it failed; trying again may work), malformed (its answer could not be used) or lost (the request never finished).

connectionrefusedupstreammalformedlost
failed_atstringRequired

When the request ended without a result. Format: date-time.

lighthouse_statestringRequired
unavailablenot_requestedpendingfailedreadyno_scores
metricstring or nullRequired

What the report's figures measure, the time to first byte (ttfb) or the whole response (total). Null while the audit has no measurement yet.

ttfbtotalnull
pagesarray of objectsRequired

Each page with its measurements, by cache state and environment.

Fields of each item
pathstringRequired
statesobjectRequired

The cache states measured, by key (uncached, cached), each with its measurements by environment name. A measurement is the report builder's own record of the samples taken.

titlestringRequired
psiobject or nullRequired

Google's scores, when the audit has them.

scaleobjectRequired
schema_versionintegerRequired
sectionsobjectRequired

The section keys each tab shows, in order, and whether the contact block shows.

Fields
contactbooleanRequired
simplearray of stringsRequired
technicalarray of stringsRequired

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403scope_requiredUse a token with the scope named in scope.
404noneCheck the id. You see only what your account can reach.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl https://manage.corefinity.com/api/performance-audits/5210/report \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "built_at": "2026-11-03T12:30:00+00:00",
  "report": {
    "audit": {
      "company": "Harbour & Finch",
      "created_at": "2026-11-01T09:00:00+00:00",
      "id": 5210,
      "name": "Before and after the move",
      "requests_per_measurement": 5,
      "run_at": "2026-11-03T12:30:00+00:00",
      "server_location": "London",
      "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4389.82 Safari/537.36"
    },
    "baseline": {
      "environment": "Current host",
      "host": "old.harbourandfinch.example.org",
      "url": "https://old.harbourandfinch.example.org"
    },
    "built_at": "2026-11-03T12:30:00+00:00",
    "comparisons": [
      {
        "environment": "Corefinity",
        "excluded": [],
        "faster_on": 2,
        "host": "harbourandfinch-example-com.northwind.cfstack.example.net",
        "of": 2,
        "summary": {
          "cached": {
            "baseline_avg_ms": 188.2,
            "comparison_avg_ms": 63.5,
            "diff_percent": 66.3,
            "measurements": 1,
            "saved_ms": 124.7,
            "speed_multiplier": 2.96
          },
          "overall": {
            "baseline_avg_ms": 400.3,
            "comparison_avg_ms": 152.4,
            "diff_percent": 61.9,
            "measurements": 2,
            "saved_ms": 247.9,
            "speed_multiplier": 2.63
          },
          "uncached": {
            "baseline_avg_ms": 612.4,
            "comparison_avg_ms": 241.3,
            "diff_percent": 60.6,
            "measurements": 1,
            "saved_ms": 371.1,
            "speed_multiplier": 2.54
          }
        },
        "url": "https://harbourandfinch-example-com.northwind.cfstack.example.net"
      }
    ],
    "coverage": {
      "lighthouse": false,
      "redirect_chains": false,
      "response_headers": false,
      "samples": true,
      "stage_timings": true
    },
    "lighthouse": null,
    "lighthouse_failure": null,
    "lighthouse_state": "unavailable",
    "metric": "ttfb",
    "pages": [
      {
        "path": "/",
        "states": {
          "cached": {
            "key": "cached",
            "label": "Cached",
            "measurements": {
              "Corefinity": {
                "cache_busted": false,
                "cache_miss": null,
                "comparable": true,
                "headers": null,
                "http_code": 200,
                "invalid": null,
                "measured": true,
                "metric": "ttfb",
                "ms": 63.5,
                "redirect_chain": null,
                "redirect_not_followed": false,
                "runner_average_ms": null,
                "runner_format": "v2",
                "runner_median_ms": null,
                "sample_count": 1,
                "samples": [
                  {
                    "cache_busted": false,
                    "http_code": 200,
                    "ms": 63.5,
                    "size_bytes": 48210,
                    "timing": {
                      "dns": 1,
                      "tcp": 19,
                      "tls": 40,
                      "total": 90.05,
                      "transfer": 26.55,
                      "ttfb": 3.5
                    },
                    "total_ms": 90.05,
                    "ttfb_ms": 63.5,
                    "url": "https://harbourandfinch-example-com.northwind.cfstack.example.net/"
                  }
                ],
                "timing": {
                  "dns": 1,
                  "tcp": 19,
                  "tls": 40,
                  "total": 90.05,
                  "transfer": 26.55,
                  "ttfb": 3.5
                },
                "timing_scope": "single_request",
                "url": "https://harbourandfinch-example-com.northwind.cfstack.example.net/",
                "warm_ups": 0
              },
              "Current host": {
                "cache_busted": false,
                "cache_miss": null,
                "comparable": true,
                "headers": null,
                "http_code": 200,
                "invalid": null,
                "measured": true,
                "metric": "ttfb",
                "ms": 188.2,
                "redirect_chain": null,
                "redirect_not_followed": false,
                "runner_average_ms": null,
                "runner_format": "v2",
                "runner_median_ms": null,
                "sample_count": 1,
                "samples": [
                  {
                    "cache_busted": false,
                    "http_code": 200,
                    "ms": 188.2,
                    "size_bytes": 48210,
                    "timing": {
                      "dns": 1,
                      "tcp": 19,
                      "tls": 40,
                      "total": 214.75,
                      "transfer": 26.55,
                      "ttfb": 128.2
                    },
                    "total_ms": 214.75,
                    "ttfb_ms": 188.2,
                    "url": "https://old.harbourandfinch.example.org/"
                  }
                ],
                "timing": {
                  "dns": 1,
                  "tcp": 19,
                  "tls": 40,
                  "total": 214.75,
                  "transfer": 26.55,
                  "ttfb": 128.2
                },
                "timing_scope": "single_request",
                "url": "https://old.harbourandfinch.example.org/",
                "warm_ups": 0
              }
            },
            "requested": true
          },
          "uncached": {
            "key": "uncached",
            "label": "Uncached",
            "measurements": {
              "Corefinity": {
                "cache_busted": false,
                "cache_miss": null,
                "comparable": true,
                "headers": null,
                "http_code": 200,
                "invalid": null,
                "measured": true,
                "metric": "ttfb",
                "ms": 241.3,
                "redirect_chain": null,
                "redirect_not_followed": false,
                "runner_average_ms": null,
                "runner_format": "v2",
                "runner_median_ms": null,
                "sample_count": 1,
                "samples": [
                  {
                    "cache_busted": false,
                    "http_code": 200,
                    "ms": 241.3,
                    "size_bytes": 48210,
                    "timing": {
                      "dns": 1,
                      "tcp": 19,
                      "tls": 40,
                      "total": 267.85,
                      "transfer": 26.55,
                      "ttfb": 181.3
                    },
                    "total_ms": 267.85,
                    "ttfb_ms": 241.3,
                    "url": "https://harbourandfinch-example-com.northwind.cfstack.example.net/"
                  }
                ],
                "timing": {
                  "dns": 1,
                  "tcp": 19,
                  "tls": 40,
                  "total": 267.85,
                  "transfer": 26.55,
                  "ttfb": 181.3
                },
                "timing_scope": "single_request",
                "url": "https://harbourandfinch-example-com.northwind.cfstack.example.net/",
                "warm_ups": 0
              },
              "Current host": {
                "cache_busted": false,
                "cache_miss": null,
                "comparable": true,
                "headers": null,
                "http_code": 200,
                "invalid": null,
                "measured": true,
                "metric": "ttfb",
                "ms": 612.4,
                "redirect_chain": null,
                "redirect_not_followed": false,
                "runner_average_ms": null,
                "runner_format": "v2",
                "runner_median_ms": null,
                "sample_count": 1,
                "samples": [
                  {
                    "cache_busted": false,
                    "http_code": 200,
                    "ms": 612.4,
                    "size_bytes": 48210,
                    "timing": {
                      "dns": 1,
                      "tcp": 19,
                      "tls": 40,
                      "total": 638.95,
                      "transfer": 26.55,
                      "ttfb": 552.4
                    },
                    "total_ms": 638.95,
                    "ttfb_ms": 612.4,
                    "url": "https://old.harbourandfinch.example.org/"
                  }
                ],
                "timing": {
                  "dns": 1,
                  "tcp": 19,
                  "tls": 40,
                  "total": 638.95,
                  "transfer": 26.55,
                  "ttfb": 552.4
                },
                "timing_scope": "single_request",
                "url": "https://old.harbourandfinch.example.org/",
                "warm_ups": 0
              }
            },
            "requested": true
          }
        },
        "title": "Home"
      }
    ],
    "psi": null,
    "scale": {
      "max_ms": 700,
      "observed_max_ms": 612.4
    },
    "schema_version": 2
  },
  "sections": {
    "contact": true,
    "simple": [
      "hero",
      "at_a_glance",
      "response_times",
      "gap",
      "improvement",
      "absolute_times",
      "waterfall",
      "full_table",
      "definitions"
    ],
    "technical": [
      "method",
      "timing_breakdown",
      "samples",
      "all_metrics"
    ]
  }
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT