Get a Webflow
Retrieve webflow progress, recipient links and non-sensitive answers.
GET https://api.nextsign.dk/v3/api/webflows/{id}Retrieve a webflow belonging to the API key's company. This also works for webflows started in the dashboard. Deleted webflows are not returned.
curl 'https://api.nextsign.dk/v3/api/webflows/65ab12cd34ef56ab78cd90b1' \
--header "Authorization: Bearer $NEXTSIGN_API_KEY"The response is 200 OK with the same { "webflow": ... } envelope as Send a Webflow.
| Field | Meaning |
|---|---|
id, formId | Webflow ID and original form ID. |
title, referenceId | Title and your reference (null if absent). |
state | awaiting-responses or completed, based on the webflow's submitted state. This is not the signing status. |
createdAt, completedAt | ISO timestamps; completion time is null until recorded. |
caseId | Resulting signing case ID when available, otherwise null. Use Get a Case for signing progress. |
recipients | Recipient progress and answers as detailed below. |
Each recipient contains id, role, name, email, requiresResponse, completed, invitationStatus, formUrl and answers. formUrl is null when the recipient is complete or is not required to answer. Dashboard-created flows have not-requested as their API invitation status; that does not mean the dashboard never sent an email.
Answers
Answers are returned only after the recipient is marked complete, and only for declared fields assigned to that recipient in the saved form snapshot. Before completion, answers is empty; prefilled values are not themselves submitted answers. Sensitive/encrypted answers are redacted, even after completion:
[
{ "tag": "phone", "value": "12345678" },
{ "tag": "customer_cpr", "redacted": true }
]An empty array means no eligible answers are stored. Raw form snapshots, encryption ciphertext, CPR metadata and internal credentials are not included. Personal form links and non-sensitive answers should still be handled as private customer data.
Poll with a reasonable interval and back off after errors. This API addition does not introduce a webflow-completion webhook.
Errors
An invalid ID returns 400 validation-failed. An unknown ID, another company's webflow, or a deleted webflow returns 404 webflow-not-found. See Authorization for authentication failures.