---
title: "List listings"
method: GET
path: "/api/files/listings"
tags: ["Listings"]
---

# List listings

`GET /api/files/listings`

List listings for the current subscriber with optional filters. If pageNumber is greater than 1 and no results are found, the endpoint returns 422.

### Validation & Requirements
#### Required Parameters
- None

#### Required JSON Body Fields
- None

#### Validations
- Invalid GUID values in `*Guid`/`*Guids` fields return `422 Unprocessable Entity`.
- Invalid date values in `*date*` fields return `422 Unprocessable Entity`.
- Missing required request body returns `422 Unprocessable Entity` with `Missing request body.`.
- Additional business-rule validation may return `422` with details in the `errors` array.
- earliestDate and latestDate must be >= 0 when provided.
- latestDate must be greater than or equal to earliestDate when both are provided.
- agentGuid and createdByGuid must belong to the subscriber when provided.

## Query parameters

- `earliestDate` integer, nullable
- `latestDate` integer, nullable
- `agentGuid` string, guid, nullable
- `createdByGuid` string, guid, nullable
- `pageNumber` integer, nullable

## Response `200`

- LinkedResponseOfGetListingsResponse
  - `value` GetListingsResponse
    - `listings` ListingsDTO[], nullable
      - `mlsNumber` string, nullable
      - `listingGuid` string, guid
      - `propertyAddress` string, nullable
      - `status` string, nullable
      - `expirationDate` string, date-time
      - `listingPrice` number
      - `link` Link
        - `href` string, nullable
        - `rel` string, nullable
        - `method` string, nullable
      - `realPropertyType` string, nullable
      - `realPropertySubtype` string, nullable
      - `checklistModifiedOn` string, date-time, nullable
      - `reviewerGuid` string, guid, nullable
  - `warnings` string[], nullable
  - `links` Link[], nullable
    - `href` string, nullable
    - `rel` string, nullable
    - `method` string, nullable

## Other responses

- `404`
- `422`

---

[API](https://skmtc.net/skyslope/apis/skyslope-api.md) · [All operations](https://skmtc.net/skyslope/apis/skyslope-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skyslope/skyslope-api/revisions/bad0d2db9b7a/schema)