List performance audits
Answers the audits of the companies you may access, newest first, without their results. Paged by cursor: send next_cursor back as cursor; null means the last page.
Query parameters
Items a page. Defaults to 25. 1 to 100.
The next_cursor of the previous answer. Anything that is not a whole number is refused 422 on cursor.
Keeps the audits of one company among those you may access. At least 1.
Returns
200 One page of audits.
Fields of the 200 answer
Send as cursor to read the next page. Null on the last page.
Fields of each item
At least 1.
Format: date-time.
Fields of each item
Whether an HTTP authentication username or password is set.
At least 1.
Fields of each item
The shared report's state. It never holds the link itself or the password.
Fields
When the figures the link shows were built. Format: date-time.
Whether a link made before the report existed still shows its response times and statuses.
Format: date-time.
Fields of each item
heroat_a_glanceresponse_timesgapimprovementabsolute_timeswaterfallfilmstripfull_tablegoogle_scoresdefinitionsmethodtiming_breakdownsamplesstatus_codesresponse_headersraw_lighthouse_jsonall_metricsctasimpletechnicalbothWhether the report link works.
Format: date-time.
The username the link asks for. Null while it is not protected.
The last run started through the API or MCP.
Fields
Why a failed run failed.
Format: date-time.
Format: date-time.
Format: date-time.
Null for an audit never run through the API.
queuedrunningcompletedfailednullWhere the runs are made from. Null when the location no longer exists.
Format: date-time.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | scope_required | Use a token with the scope named in scope. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait 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 \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/performance-audits');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/performance-audits', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.get(
"https://manage.corefinity.com/api/performance-audits",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"items": [
{
"company_id": 1204,
"created_at": "2026-11-01T09:00:00+00:00",
"domains": [
{
"environment": "Current host",
"http_auth": false,
"url": "https://old.harbourandfinch.example.org"
},
{
"environment": "Corefinity",
"http_auth": true,
"url": "https://harbourandfinch-example-com.northwind.cfstack.example.net"
}
],
"id": 5210,
"name": "Before and after the move",
"number_of_requests": 5,
"page_types": [
{
"check_cache": true,
"path": "/",
"title": "Home"
},
{
"check_cache": false,
"path": "/shop/",
"title": "Category"
}
],
"report": {
"frozen_at": null,
"legacy_link_live": false,
"password_protected": false,
"revoked_at": null,
"sections": [
{
"enabled": true,
"key": "hero",
"label": "Headline",
"tab": "simple"
},
{
"enabled": true,
"key": "at_a_glance",
"label": "At a glance",
"tab": "simple"
},
{
"enabled": true,
"key": "response_times",
"label": "Response times",
"tab": "simple"
},
{
"enabled": true,
"key": "gap",
"label": "The gap, measurement by measurement",
"tab": "simple"
},
{
"enabled": true,
"key": "improvement",
"label": "Improvement per measurement",
"tab": "simple"
},
{
"enabled": true,
"key": "absolute_times",
"label": "Absolute times, side by side",
"tab": "simple"
},
{
"enabled": true,
"key": "waterfall",
"label": "Where the time actually goes",
"tab": "simple"
},
{
"enabled": true,
"key": "filmstrip",
"label": "Loading filmstrip",
"tab": "simple"
},
{
"enabled": true,
"key": "full_table",
"label": "The full table",
"tab": "simple"
},
{
"enabled": true,
"key": "google_scores",
"label": "Google scores",
"tab": "simple"
},
{
"enabled": true,
"key": "definitions",
"label": "Definitions",
"tab": "simple"
},
{
"enabled": true,
"key": "method",
"label": "Method",
"tab": "technical"
},
{
"enabled": true,
"key": "timing_breakdown",
"label": "Timing breakdown",
"tab": "technical"
},
{
"enabled": true,
"key": "samples",
"label": "Individual samples",
"tab": "technical"
},
{
"enabled": true,
"key": "status_codes",
"label": "Status codes and redirect chains",
"tab": "technical"
},
{
"enabled": true,
"key": "response_headers",
"label": "Response headers",
"tab": "technical"
},
{
"enabled": true,
"key": "raw_lighthouse_json",
"label": "Raw Lighthouse response",
"tab": "technical"
},
{
"enabled": true,
"key": "all_metrics",
"label": "Every available metric",
"tab": "technical"
},
{
"enabled": true,
"key": "cta",
"label": "Contact Corefinity",
"tab": "both"
}
],
"shared": false,
"shared_at": null,
"username": null
},
"run": {
"error": null,
"finished_at": "2026-11-03T12:35:00+00:00",
"requested_at": "2026-11-03T12:30:00+00:00",
"started_at": "2026-11-03T12:30:00+00:00",
"status": "completed"
},
"server_location": {
"id": 12,
"name": "London"
},
"updated_at": "2026-11-03T12:35:00+00:00",
"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"
}
],
"next_cursor": null
}{
"message": "Unauthenticated."
}{
"code": "scope_required",
"message": "This access token does not have the destructive scope this needs. Use a token with the destructive scope.",
"reason": "scope_required",
"scope": "destructive"
}{
"code": "invalid",
"errors": {
"cursor": [
"The cursor format is invalid."
]
},
"field": "cursor",
"message": "The cursor format is invalid.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}