---
title: "Get create form (V2)"
method: GET
path: "/api/v2/files/listingForm"
tags: ["V2 Listings"]
---

# Get create form (V2)

`GET /api/v2/files/listingForm`

Get the dynamic create-listing form for the selected checklist type and office context, using V2 managed fields.

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

## Query parameters

- `checklistTypeId` integer
- `officeGuid` string, guid, nullable

## Response `200`

- LinkedResponseOfGetListingFormResponse
  - `value` GetListingFormResponse
    - `fields` Field[], nullable
      - `fieldName` string, nullable
      - `fieldType` string, nullable
      - `isRequired` boolean
      - `subFields` Field[], nullable
      - `allowableSelections` unknown[], nullable
        - unknown
      - `description` string, nullable
      - `label` string, nullable
      - `deprecated` boolean
      - `deprecatedAsOf` string, nullable
      - `deprecatedAvailableSelections` boolean
      - `deprecatedAvailableSelectionsAsOf` 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)