---
title: "Query for a list files which can be downloaded from the APX MarketSuite which have changed since the specified date."
method: PUT
path: "/fileRegistry/listFilesSince"
tags: ["/fileRegistry"]
---

# Query for a list files which can be downloaded from the APX MarketSuite which have changed since the specified date.

`PUT /fileRegistry/listFilesSince`

## Request

- Base URL: `https://pm-file-api.apx.com`
- URL: `https://pm-file-api.apx.com/fileRegistry/listFilesSince`
- Auth: none declared
- TypeScript: <https://skmtc.dev/xpansiv/apis/file-registry-api/docs/fileRegistry/listFilesSince/put.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `watermarkDate` string, yyyy-mm-ddThh:mm:ss, required

## Request body

- DownloadFileDescriptor
  - `region` string, required: ISO code
  - `participant` string, required: APX MarketSuite participant code
  - `fileType` string, required: APX MarketSuite File Type Name
  - `source` string, required: Data source system
  - `rendition` string, required: Type of data in the file, such as DA or RT
  - `latestVersionOnly` boolean, required: Flag indicating whether or not to list the most recent version of a file. True means list the most recent version only. False means list all versions. The default is true.

## Response `200`

List files which can be downloaded from the APX MarketSuite which have changed since the specified date

- FileItem[]
  - `location` string: Location associated with the file. Generally refers to the ISO or region
  - `participant` string: APX MarketSuite participant code
  - `intervalBegin` string: DateTime value of interval_begin that was specified when the file was uploaded or otherwise registered. This is not necessarily true for the content of the file. Format - yyyy-mm-ddThh:mm:ss
  - `intervalEnd` string: Datetime value of interval_end that was specified when the file was uploaded or otherwise registered. This is not necessarily true for the content of the file. Format - yyyy-mm-ddThh:mm:ss
  - `source` string: Data source system
  - `rendition` string: Type of data in the file, such as DA or RT
  - `fileType` string: APX MarketSuite File Type Name
  - `fileVersion` integer: Version of the file instance within the APX MarketSuite for the same business keys
  - `fileStructureVersion` number: The version of the structure of the file
  - `fileFormat` string: The format of the file (CSV, XML, etc.)
  - `fileHandle` string: Unique identifier for the file within the APX MarketSuite
  - `createDate` string: Datetime the file was created in the APX MarketSuite

## Other responses

- `400`: Bad Request
- `401`: Invalid user credentials were supplied or the user does not have authorization to perform this operation
- `500`: Internal server error

---

[API](https://skmtc.dev/xpansiv/apis/file-registry-api.md) - [All operations](https://skmtc.dev/xpansiv/apis/file-registry-api/llms.txt) - [OpenAPI document](https://skmtc.dev/xpansiv/apis/file-registry-api/revisions/1dcebe6ba687?raw)