# List

GET /feeds/latest: Lists every feed with its files (format, size, line count, update time) and the API URL to get each.

Source: https://docs.deepinfo.com/reference/feeds/list/

Last updated: 2026-09-27

---
`GET https://api.deepinfo.com/v1/feeds/latest`

Lists every feed with its files (format, size, line count, update time) and the API URL to get each.

## Authentication

Send your API key in the `apikey` request header.

## Response Fields

An array of objects:

| Field | Type |
|---|---|
| `type` | string |
| `files` | array of object |

## Response Schema

_Inferred from examples._ Built from the saved 2xx example response: the fields it contains, with the types seen there. It is not a contract. The response body is an array; `[]` marks its elements.

| Field | Type |
|---|---|
| `[].type` | string |
| `[].files` | array<object> |
| `[].files[].file_format` | string |
| `[].files[].file_size` | number |
| `[].files[].file_update_time` | string |
| `[].files[].line_count` | number |
| `[].files[].api_url` | string |

## Examples

### 200 · OK

```bash
curl 'https://api.deepinfo.com/v1/feeds/latest' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'
```

`Content-Type: application/json` · `deepinfo-request-id: 5f0c6a8e-1b2d-4c3e-9f4a-7b8c9d0e1f2a`

```json
[
  {
    "type": "all_domain",
    "files": [
      {
        "file_format": "csv",
        "file_size": 44140471934,
        "file_update_time": "2024-01-02T10:00:00Z",
        "line_count": 325178488,
        "api_url": "https://api.deepinfo.com/v1/feeds/all-domains?file_format=csv"
      },
      {
        "file_format": "json",
        "file_size": 57802199488,
        "file_update_time": "2024-01-02T10:00:00Z",
        "line_count": 325178488,
        "api_url": "https://api.deepinfo.com/v1/feeds/all-domains?file_format=json"
      }
    ]
  },
  {
    "type": "all_subdomain",
    "files": [
      {
        "file_format": "csv",
        "file_size": 53325635252,
        "file_update_time": "2024-01-04T10:00:00Z",
        "line_count": 843822487,
        "api_url": "https://api.deepinfo.com/v1/feeds/all-subdomains?file_format=csv"
      },
      {
        "file_format": "json",
        "file_size": 79516075771,
        "file_update_time": "2024-01-04T10:00:00Z",
        "line_count": 843822487,
        "api_url": "https://api.deepinfo.com/v1/feeds/all-subdomains?file_format=json"
      }
    ]
  }
]
```

## Worked Examples

Worked examples of this endpoint, each on its own page with the exact request and its response: [Feed List Examples](/reference/feeds/list/examples/).

- [Every Feed and Its Files](/reference/feeds/list/examples/default/): Every feed and its files: six feeds, each as CSV, JSON and Parquet, with size, line count, update time and api_url.