---
title: "The organization's feed contracts and where each one stands"
method: GET
path: "/v2/feeds"
tags: ["feeds"]
---

# The organization's feed contracts and where each one stands

`GET /v2/feeds`

## Request

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

Every active feed contract the key's organization holds, each with the pointer to its current run or `null` before the first run. A feed is the organization's own data set, built nightly from the Canadian vehicle record and scoped to what the organization is entitled to. Org key only: a user key or session is 403 `forbidden`. Costs 0 credits.

## Response `200`

The contracts and their current runs

- FeedsList
  - `feeds` object[], required
    - `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
    - `latest` object, nullable, required
      - `runId` string, required
      - `kind` 'full' | 'delta', required
      - `producedAt` string, date-time, required

## Other responses

- `401`: No valid credential (API key, session, or internal token)
- `403`: Credential lacks the scope for this route group (`forbidden`)
- `429`: Per-minute rate limit exceeded
- `500`: Internal error

---

[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)