---
title: "Get listing"
method: GET
path: "/api/files/listings/{listingGuid}"
tags: ["Listings"]
---

# Get listing

`GET /api/files/listings/{listingGuid}`

Get a single listing by GUID. Returns full listing data including contacts, checklist, commissions, and related workflow links.

### Validation & Requirements
#### Required Parameters
- `listingGuid` (path, string, format=guid)

#### 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.

## Path parameters

- `listingGuid` string, guid, required

## Response `200`

- LinkedResponseOfGetListingResponse
  - `value` GetListingResponse
    - `listing` ListingDTO
      - `agentGuid` string, guid
      - `checklist` Checklist
        - `activities` ChecklistActivity[], nullable
          - `activityId` integer
          - `activityName` string, nullable
          - `dateAssigned` string, date-time, nullable
          - `comments` ChecklistComment[], nullable
            - `comment` string, nullable
            - `createdBy` string, nullable
            - `createdOn` string, nullable
          - `docs` string[], nullable
          - `checklistDocs` ChecklistDocument[], nullable
            - `id` string, nullable
            - `name` string, nullable
            - `url` string, nullable
            - `documentServiceKey` string, nullable
            - `modifiedDate` string, date-time, nullable
            - `uploadDate` string, date-time, nullable
            - `dateAssigned` string, date-time, nullable
            - `fileName` string, nullable
            - `extension` string, nullable
            - `fileSize` integer, nullable
            - `pages` integer, nullable
          - `help` string, nullable
          - `order` integer
          - `status` string, nullable
          - `typeId` integer
          - `typeName` string, nullable
          - `modifiedOn` string, date-time, nullable
        - `typeId` integer
        - `typeName` string, nullable
      - `checklistType` string, nullable
      - `coAgentGuids` string[], nullable
      - `transactionCoordinators` TransactionCoordinatorDTO[], nullable
        - `contactGuid` string, guid
        - `firstName` string, nullable
        - `lastName` string, nullable
        - `fullName` string, nullable
        - `email` string, nullable
        - `phoneNumber` string, nullable
        - `notes` string, nullable
        - `fee` number, nullable
        - `hasAccess` boolean
      - `coListingAgentGuid` string, guid, nullable
      - `commercialLease` CommercialLeaseDTO
        - `size` number, nullable
        - `sizeType` string, nullable
      - `commission` CommissionDTO
        - `commissionBreakdown` string, nullable
        - `listingCommissionAmount` number, nullable
        - `listingCommissionPercent` number, nullable
        - `officeGrossCommission` number, nullable
        - `referralAmount` number, nullable
        - `referralAmountPercent` number, nullable
        - `saleCommissionPercent` number, nullable
        - `salesCommissionAmount` number, nullable
        - `transCoordinatorFee` number, nullable — Deprecated. Use AdminBrokerageComp for broker fees or the /transactionCoordinators endpoint for TC-specific fees.
        - `adminBrokerageComp` number, nullable — Admin brokerage compensation fee. Replaces TransCoordinatorFee for broker fee purposes.
      - `commissionReferral` CommissionReferral
        - `amount` number, nullable
        - `brokerageName` string, nullable
        - `contact` CommissionReferralContact
          - `email` string, nullable
          - `firstName` string, nullable
          - `guid` string, guid
          - `lastName` string, nullable
          - `phoneNumber` string, nullable
        - `percent` number, nullable
      - `listingEmail` string, nullable
      - `company` string, nullable
      - `createdByGuid` string, guid
      - `createdOn` string, date-time
      - `checklistModifiedOn` string, date-time, nullable
      - `deadDate` string, date-time, nullable — The date the listing was cancelled. Null if the listing has not been cancelled.
      - `reviewerGuid` string, guid, nullable
      - `customFields` unknown
      - `expirationDate` string, date-time
      - `fileId` string, nullable
      - `homeWarranty` HomeWarrantyContactDTO2
        - `company` string, nullable
        - `confirmationNumber` string, nullable
        - `contactGuid` string, guid
        - `notes` string, nullable
        - `phoneNumber` string, nullable
        - `representativeName` string, nullable
      - `listingDate` string, date-time
      - `listingGuid` string, guid
      - `listingPrice` number
      - `miscContact` MiscellaneousContactDTO2
        - `alternatePhone` string, nullable
        - `city` string, nullable
        - `company` string, nullable
        - `contactGuid` string, guid
        - `email` string, nullable
        - `fax` string, nullable
        - `firstName` string, nullable
        - `lastName` string, nullable
        - `miscContactType` string, nullable
        - `notes` string, nullable
        - `phoneNumber` string, nullable
        - `state` string, nullable
        - `streetName` string, nullable
        - `streetNumber` string, nullable
        - `zip` string, nullable
      - `mlsNumber` string, nullable
      - `officeGuid` string, guid, nullable
      - `otherSource` string, nullable
      - `property` PropertyDTO
        - `areasqft` string, nullable
        - `city` string, nullable
        - `county` string, nullable
        - `direction` string, nullable
        - `realPropertySubtypeId` integer, nullable
        - `realPropertyTypeId` integer, nullable
        - `state` string, nullable
        - `streetAddress` string, nullable
        - `streetNumber` string, nullable
        - `unit` string, nullable
        - `yearBuilt` integer, nullable
        - `zip` string, nullable
      - `realPropertySubtype` string, nullable
      - `realPropertyType` string, nullable
      - `referringAgentGuid` string, guid, nullable
      - `sellers` SellerDTO2[], nullable
        - `alternatePhone` string, nullable
        - `city` string, nullable
        - `company` string, nullable
        - `contactGuid` string, guid
        - `email` string, nullable
        - `fax` string, nullable
        - `firstName` string, nullable
        - `isTrustCompanyOrOtherEntity` boolean
        - `lastName` string, nullable
        - `notes` string, nullable
        - `phoneNumber` string, nullable
        - `state` string, nullable
        - `streetName` string, nullable
        - `streetNumber` string, nullable
        - `zip` string, nullable
      - `source` string, nullable
      - `sourceId` integer, nullable
      - `stage` StageDTO
        - `id` integer
        - `name` string, nullable
      - `status` string, nullable
      - `type` string, 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)