curl --request GET \
--url https://api.formabledocs.com/v1/signature-requests/{signatureRequestId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.formabledocs.com/v1/signature-requests/{signatureRequestId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.formabledocs.com/v1/signature-requests/{signatureRequestId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.formabledocs.com/v1/signature-requests/{signatureRequestId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.formabledocs.com/v1/signature-requests/{signatureRequestId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.formabledocs.com/v1/signature-requests/{signatureRequestId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.formabledocs.com/v1/signature-requests/{signatureRequestId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"signatureRequestId": "sr_abc123",
"templateId": "tmpl_abc123",
"signers": [
{
"email": "signer@example.com",
"name": "Jane Doe",
"recipientSignatureId": "rsig_abc123"
},
{
"email": "witness@example.com",
"name": "Pat Lee",
"recipientSignatureId": "rsig_def456"
}
],
"sender": {
"email": "sender@example.com",
"name": "John Smith"
},
"status": "Created",
"testMode": false,
"fields": [
{
"fieldId": "field_name",
"type": "text",
"required": true,
"filled": true,
"label": "Name",
"role": "Client",
"recipientSignatureId": "rsig_abc123",
"value": "Jane Doe"
},
{
"fieldId": "field_sig",
"type": "signature",
"required": true,
"filled": true,
"role": "Client",
"recipientSignatureId": "rsig_abc123",
"value": null,
"signedAt": "2026-01-15T12:00:00.000Z"
},
{
"fieldId": "field_amount",
"type": "amount",
"required": false,
"filled": true,
"recipientSignatureId": null,
"value": 1500,
"unit": "$"
}
]
}{
"error": "SignatureRequestId is required"
}{
"error": "Auth token not valid"
}{
"error": "Client not authorized to get a signature request for this signature request"
}{
"error": "Signature request not found for id abc123xyz"
}{
"error": "Internal server error"
}Get a signature request
Retrieves the signature request by ID. The response matches create: a signers
array (each with recipientSignatureId) and envelope fields with current
values. Signature image data is never returned; signature fields use
value: null and include signedAt when signed. Use status to poll
progress, signers to mint signing URLs, and fields to see what has been filled.
curl --request GET \
--url https://api.formabledocs.com/v1/signature-requests/{signatureRequestId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.formabledocs.com/v1/signature-requests/{signatureRequestId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.formabledocs.com/v1/signature-requests/{signatureRequestId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.formabledocs.com/v1/signature-requests/{signatureRequestId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.formabledocs.com/v1/signature-requests/{signatureRequestId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.formabledocs.com/v1/signature-requests/{signatureRequestId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.formabledocs.com/v1/signature-requests/{signatureRequestId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"signatureRequestId": "sr_abc123",
"templateId": "tmpl_abc123",
"signers": [
{
"email": "signer@example.com",
"name": "Jane Doe",
"recipientSignatureId": "rsig_abc123"
},
{
"email": "witness@example.com",
"name": "Pat Lee",
"recipientSignatureId": "rsig_def456"
}
],
"sender": {
"email": "sender@example.com",
"name": "John Smith"
},
"status": "Created",
"testMode": false,
"fields": [
{
"fieldId": "field_name",
"type": "text",
"required": true,
"filled": true,
"label": "Name",
"role": "Client",
"recipientSignatureId": "rsig_abc123",
"value": "Jane Doe"
},
{
"fieldId": "field_sig",
"type": "signature",
"required": true,
"filled": true,
"role": "Client",
"recipientSignatureId": "rsig_abc123",
"value": null,
"signedAt": "2026-01-15T12:00:00.000Z"
},
{
"fieldId": "field_amount",
"type": "amount",
"required": false,
"filled": true,
"recipientSignatureId": null,
"value": 1500,
"unit": "$"
}
]
}{
"error": "SignatureRequestId is required"
}{
"error": "Auth token not valid"
}{
"error": "Client not authorized to get a signature request for this signature request"
}{
"error": "Signature request not found for id abc123xyz"
}{
"error": "Internal server error"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The ID of the signature request
Response
Signature request retrieved successfully
The unique identifier of the signature request
"sr_abc123"
The template ID associated with the signature request
"tmpl_abc123"
People who will sign, in signing order
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Current status of the signature request
Created, Completed, Expired "Created"
Whether the signature request is in test mode
false
Envelope fields with current values. Signature image data is never returned.
Show child attributes
Show child attributes