---
title: "Look up a submission data request"
method: GET
path: "/data_requests/{data_request_id}"
tags: ["Data Requests"]
---

# Look up a submission data request

`GET /data_requests/{data_request_id}`

Retrieves the details and status of a data request. Returns information about the request
state (pending, viewed, completed), authentication details, and metadata.
Includes audit information like IP address, browseruser agent, and timestamps.

See also:
- [Embedded Data Requests Guide](https://docspring.com/docs/guides/embedded-forms/embedded-data-requests/) - Complete guide to data request workflow

## Path parameters

- `data_request_id` string, required

## Response `200`

completed submission data request found

- SubmissionDataRequestShow
  - `id` string, nullable, required
  - `email` string, nullable, required
  - `name` string, nullable, required
  - `order` integer, nullable, required
  - `sort_order` integer, required
  - `fields` string[], nullable, required
  - `metadata` object, nullable, required
  - `state` 'pending' | 'completed', required
  - `viewed_at` string, nullable, required
  - `completed_at` string, nullable, required
  - `data` object, nullable, required
  - `auth_type` 'none' | 'password' | 'oauth' | 'email_link' | 'phone_number' | 'ldap' | 'saml', required
  - `auth_second_factor_type` 'none' | 'phone_number' | 'totp' | 'mobile_push' | 'security_key' | 'fingerprint', required
  - `auth_provider` string, nullable, required
  - `auth_session_started_at` string, nullable, required
  - `auth_session_id_hash` string, nullable, required
  - `auth_user_id_hash` string, nullable, required
  - `auth_username_hash` string, nullable, required
  - `auth_phone_number_hash` string, nullable, required
  - `ip_address` string, nullable, required
  - `user_agent` string, nullable, required
  - `submission_id` string, nullable, required

## Other responses

- `401` — authentication failed
- `404` — submission data request not found

---

[API](https://skmtc.dev/docspring/apis/docspring-api.md) · [All operations](https://skmtc.dev/docspring/apis/docspring-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/docspring/docspring-api/revisions/5726657b9432/schema)