---
title: "Retrieve Design Request"
method: GET
path: "/tenants/{tenant_id}/design_requests/{id}"
tags: ["Design Requests"]
---

# Retrieve Design Request

`GET /tenants/{tenant_id}/design_requests/{id}`

Retrieve a design request by ID.

## Path parameters

- `tenant_id` string, uuid, required
- `id` string, uuid, required

## Response `200`

Design Request successfully retrieved.

- object
  - `design_request` object
    - `id` string, uuid — Unique ID identifying the design request.
    - `project_id` string, uuid — Unique ID identifying the project that the design request belongs to.
    - `status` 'submitted' | 'designer_completed' | 'designer_rejected' | 'accepted' | 'rejected' — The status of the design request
    - `latitude` number, double — Latitude of the building to be modeled.
    - `longitude` number, double — Longitude of the building to be modeled.
    - `address` string — Address, denormalized from the project
    - `submitted_at` string, date-time — Timestamp of design request submission time in UTC.
    - `completed_at` string, date-time — Timestamp of design request completion time in UTC.
    - `reviewed_at` string, date-time — Timestamp of design request review time in UTC.
    - `designer_rejected_at` string, date-time — Timestamp of design request designer rejected time in UTC.
    - `image_src` 'Google' | 'Bing' | 'Google HD (Sunroof)' | 'Nearmap' | 'Nearmap (True Ortho)' | 'EagleView' | 'Vexcel' | 'Custom' — Image source used by the designer when creating the 3D Model.
    - `lidar_src` 'Google Sunroof' | 'Aurora Lidar' | 'Vexcel Lidar' | 'Unknown' — Lidar source used by the designer when creating the 3D Model.
    - `design_id` string, uuid — Unique ID identifying the design that the design request corresponds to. Only populated if the design request has been accepted.
    - `sla` integer — ETA in minutes until request completion from submission time.
    - `designer_rejection_reason` string[] — Reasons why the designer rejected the request. Only populated if the design request has been rejected.
    - `auto_accept` boolean — Whether or not it should be autoaccepted upon completion. Defaults to false.
    - `auto_accepted` boolean — Whether or not it has been autoaccepted. Starts as false, then moves to true upon autoaccept.
    - `roof_pitch` integer — Angle of roof pitch in degrees, typically from 0 to 60. Defaults to null. This field is not used by our Expert Design Service in all tenants. For availability, please contact your Aurora account team.
    - `number_of_stories` integer — The height of the main structure of this request in stories. Defaults to null. This field is not used by our Expert Design Service in all tenants. For availability, please contact your Aurora account team.
    - `vendor_used_lidar` boolean — Deprecated, please use `designer_used_lidar` instead.
    - `vendor_used_default_pitch` boolean — Deprecated, please use `designer_used_default_pitch` instead.
    - `designer_used_lidar` boolean — Whether or not the designer used lidar when constructing this roof model. Defaults to null. Possible values are [true, false, null]. For availability, please contact your Aurora account team.
    - `designer_used_default_pitch` boolean — Whether or not the designer used the default roof pitch when constructing this roof model. Defaults to null. Possible values are [true, false, null]. For availability, please contact your Aurora account team.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

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