> ## Documentation index
> Fetch the complete documentation index at: https://rankfield.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Dataset Status

> Get the web graph release Rankfield serves now: its date, build, scoring version and how many domains and links it holds.

`GET https://rankfield.dev/v1/datasets/current`

```bash cURL
curl 'https://rankfield.dev/v1/datasets/current' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

```python Python
import requests

response = requests.get(
    "https://rankfield.dev/v1/datasets/current",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())
```

```javascript JavaScript
const response = await fetch("https://rankfield.dev/v1/datasets/current", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
  },
});
console.log(await response.json());
```

```json 200
{
  "graph": {
    "release": "2026-may-jun-jul",
    "asOf": "2026-08-19T00:00:00Z",
    "siteStrengthVersion": "authority-continuous-counts-0.3.1",
    "siteStrengthVersionSource": "live",
    "completeRelationships": true,
    "buildId": "graph-2026mayjunjul-v3",
    "domains": 117963409,
    "unscoredDomains": 0,
    "inboundRelationships": 2774625913,
    "outboundRelationships": 2774625913,
    "selfEdgesExcluded": 0,
    "sourceEdges": 2774625913
  },
  "pageEvidence": { "ready": false, "crawls": [], "observedThrough": null, "extractionVersion": null },
  "backlinkIndex": { "ready": false, "buildId": null, "inputFiles": null, "linkObservations": null, "publishedAt": null },
  "coverageNote": "Counts refer to observed records in the published Rankfield dataset; missing page evidence is unavailable, not a missing link."
}
```

Call it once per session to know which release your answers come from, or to notice when a new release is published.

## Response

| Field | Type | Description |
|---|---|---|
| `graph.release` | string | The web graph release, such as `2026-may-jun-jul` (built from crawls of May, June and July 2026). |
| `graph.asOf` | string | The release date (UTC). |
| `graph.siteStrengthVersion` | string | The Site Strength scoring version in effect now: the one Site Strength and Referring Domains answers carry. |
| `graph.siteStrengthVersionSource` | string | `live`: read from the Site Strength service as it answers now. `manifest`: the service did not answer within a second, so this is the graph manifest's version. |
| `graph.buildId` | string | The index build that answers list requests. |
| `graph.domains` | integer | Domains in the graph. |
| `graph.inboundRelationships`, `graph.outboundRelationships` | integer | Domain-to-domain links, counted from each side. |
| `graph.completeRelationships` | boolean | Whether every list is complete for this release. |
| `pageEvidence`, `backlinkIndex` | object | Page-level link evidence. `ready: false`: source page URLs and anchors are not available. |

## MCP

On the [MCP server](/docs/agents/mcp-server), the tool for this is `get_dataset_status`.
