---
title: "List Od Files V2"
method: GET
path: "/od/{object_id}/v2"
tags: ["Orbital Determination"]
---

# List Od Files V2

`GET /od/{object_id}/v2`

Get a paginated, filtered list of OD files for a specific object, including the exact number of matching files.

## Path parameters

- `object_id` integer, required — The norad/temporary id of the object.

## Query parameters

- `today` boolean
- `results` boolean
- `year` integer, nullable — Optional output year filter. Applies to files under output/<year>/.
- `file_type` 'all' | 'opm' | 'pdf' | 'txt' | 'json' | 'csv' | 'navsol' — Optional file extension filter. Use all to return every file type.
- `search` string, nullable — Optional case-insensitive substring filter applied to available filenames.
- `group_id` string, uuid, nullable — Optional group ID to use for the request
- `offset` integer
- `count` integer
- `sort_field` string
- `sort_direction` 'asc' | 'desc'

## Response `200`

Successful Response

- OffsetPageResultDict
  - `pagination` OffsetPagination, required
    - `offset` integer — Offset in the collection to begin the page.
    - `count` integer — Number of items to retrieve. 0 returns all items.
  - `items` object[], required
  - `total_count` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-22** `e83b4e399119` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/satcat/apis/satcat-service-api/changes/od/:object_id/v2/get.md)

---

[API](https://skmtc.dev/satcat/apis/satcat-service-api.md) · [All operations](https://skmtc.dev/satcat/apis/satcat-service-api/llms.txt) · [OpenAPI document](https://skmtc.dev/satcat/apis/satcat-service-api/revisions/9a3b0a312528?raw)