---
title: "The current run of one dataset, with signed links to its artifacts"
method: GET
path: "/v2/feeds/{dataset}/latest"
tags: ["feeds"]
---

# The current run of one dataset, with signed links to its artifacts

`GET /v2/feeds/{dataset}/latest`

## Request

- Base URL: `https://api.cardog.app`
- URL: `https://api.cardog.app/v2/feeds/{dataset}/latest`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

The manifest of the current run, the dataset declaration the rows are typed by, and one signed 24-hour link per artifact (`full`, `delta`, and `deletes` when the dataset declares deletes). Open a link exactly as printed; it needs no key and costs 0 credits. Rows are csv, RFC 4180 quoted, sorted by the first field; a VIN matches a row by its pattern (positions 1–8, `*`, 10–11, plus 12–14 when position 3 is `9`). 404 when the organization holds no active contract for the dataset or no run has been published yet. Org key only.

## Path parameters

- `dataset` string, required

## Response `200`

The current run, ready to read

- FeedLatest
  - `contract` object, required
    - `dataset` string, required
    - `fieldmap` string, required
    - `format` 'csv.gz' | 'csv' | 'jsonl.gz' | 'jsonl' | 'json.gz' | 'json' | 'parquet' | 'pipe-csv', required
    - `status` 'active' | 'draft' | 'suspended', required
    - `cadence` object, required
      - `full` boolean, required
      - `delta` boolean, required
      - `weekly_full` boolean, required
  - `dataset` object, required
    - `id` string, required
    - `title` string, required
    - `status` 'ratified' | 'draft', required
    - `presets` object[]
      - `id` string, required
      - `title` string, required
      - `description` string, required
      - `fields` string[], required
    - `key` string[]
    - `ratifiedAt` string, date-time
    - `semantics` object, required
      - `upsert` boolean, required
      - `delete` boolean, required
    - `fields` object[], required
      - `name` string, required
      - `type` 'string' | 'integer' | 'number' | 'boolean' | 'date' | 'timestamp' | 'ref', required
      - `required` boolean, required
      - `joinKey` boolean
      - `lifecycle` string
      - `description` string
      - `group` string
      - `preset` boolean
      - `pairedWith` string
  - `manifest` object, required
    - `schema` 'feed-manifest@1', required
    - `contract` string, required
    - `dataset` string, required
    - `fieldmap` string, required
    - `runId` string, required
    - `kind` 'full' | 'delta', required
    - `baselineRunId` string
    - `artifacts` object[], required
      - `name` string, required
      - `records` integer, required
      - `bytes` integer, required
      - `sha256` string, required
    - `window` object, required
      - `from` string, date-time, required
      - `to` string, date-time, required
    - `producedAt` string, date-time, required
    - `destinationPrefix` string, required
    - `columns` object[]
      - `name` string, required
      - `source` string, required
      - `type` 'string' | 'integer' | 'number' | 'boolean' | 'date' | 'timestamp' | 'ref', required
      - `mapped` boolean
    - `layout` object
      - `delimiter` ',' | '|' | '	' | ';', required
      - `header` boolean, required
      - `lineEnding` 'lf' | 'crlf', required
  - `artifacts` object[], required
    - `name` string, required
    - `records` integer, required
    - `bytes` integer, required
    - `sha256` string, required
    - `url` string, uri, required
    - `expiresAt` string, date-time, required
  - `columns` object[]
    - `name` string, required
    - `source` string, required
    - `type` 'string' | 'integer' | 'number' | 'boolean' | 'date' | 'timestamp' | 'ref', required
    - `mapped` boolean
  - `layout` object
    - `delimiter` ',' | '|' | '	' | ';', required
    - `header` boolean, required
    - `lineEnding` 'lf' | 'crlf', required

## Other responses

- `400`: Invalid request — grammar failure or unknown-but-well-formed refs, NAMED in `refs`/`details`, with nearest-ref `suggestions` where computable. Never a fuzzy fallback.
- `401`: No valid credential (API key, session, or internal token)
- `403`: Credential lacks the scope for this route group (`forbidden`)
- `404`: Resource not found
- `429`: Per-minute rate limit exceeded
- `500`: Internal error
- `503`: Temporarily unavailable (`unavailable`); retry with backoff

---

[API](https://skmtc.dev/cardog/apis/cardog-api-v2.md) · [All operations](https://skmtc.dev/cardog/apis/cardog-api-v2/llms.txt) · [OpenAPI document](https://skmtc.dev/cardog/apis/cardog-api-v2/revisions/b9d48193126f?raw)