---
title: "Read Harvested File"
method: GET
path: "/datacatalog/api/harvest/files/{id}"
tags: ["Harvest"]
---

# Read Harvested File

`GET /datacatalog/api/harvest/files/{id}`

## Request

- Base URL: `https://data.usgs.gov` (the document declares no server; this is the origin it was published from)
- URL: `https://data.usgs.gov/datacatalog/api/harvest/files/{id}`
- Auth: none declared

Get harvested_file by ID.

Example: 2-httpalaskausgsgovdatametadataecosystemsaerialimagerylowaltitudewildcastnadirphotosxml

## Path parameters

- `id` string, required

## Response `200`

Successful Response

- HarvestedFileExtended: The HarvestedFileExtended class is currently used by routes that retrieve harvested files regardless of status: `/files` and `/files/{id}`.
  - `id` string, required
  - `date_first_harvested` string, date-time, required
  - `date_effective` string, date-time, required
  - `date_last_harvested` string, date-time, required
  - `date_modified` string, date-time, nullable
  - `date_indexed` string, date-time, nullable
  - `data_source_id` integer, nullable
  - `data_source_name` string, nullable
  - `file_url` string, required
  - `file_removed` boolean, required
  - `filename` string, required
  - `record_checks` RecordChecks, required
    - `xml_valid` boolean, required
    - `doi_present` boolean, required
    - `pid_in_file` boolean, required
    - `mdate_present` boolean, required
    - `pid_in_pir_db` boolean, required
    - `title_present` boolean, required
    - `email_contact_present` boolean, required
  - `metadata_cntemail` string, nullable
  - `metadata_doi` string, nullable
  - `metadata_mdate` string, nullable
  - `metadata_pid` string, nullable
  - `metadata_title` string, nullable
  - `pid_url` string, nullable
  - `authors` Author[], nullable
    - `author_name` string, required
    - `name_type` 'Personal' | 'USGSPersonal' | 'Organizational', required
    - `orcid` string, nullable
  - `repository` Repository
    - `id` integer, required
    - `name` 'Alaska Science Center' | 'Coastal and Marine Geoscience Data System' | 'Earth Resources Observation and Science Center' | 'Geoscience Data Catalog' | 'Individual Metadata Uploader' | 'National Uranium Resource Evaluation' | 'ScienceBase' | 'SDC Metadata Bridge' | 'Water NSDI Node', required
    - `short_name` string, required
    - `type` string, required
    - `url` string, uri, required

## Other responses

- `404`: Not found
- `422`: Validation Error

---

[API](https://skmtc.dev/usgs/apis/usgs-science-data-catalog-api-documentation.md) - [All operations](https://skmtc.dev/usgs/apis/usgs-science-data-catalog-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/usgs/apis/usgs-science-data-catalog-api-documentation/revisions/f5f6a07ba13f?raw)