Get Started
Integrate / SDKs
User Verification
Business Verification
Transaction Monitoring
ChangelogDownload a signature image
curl --request GET \
--url https://verification.didit.me/v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/ \
--header 'x-api-key: <api-key>'import requests
url = "https://verification.didit.me/v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://verification.didit.me/v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/', 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://verification.didit.me/v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$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://verification.didit.me/v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://verification.didit.me/v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://verification.didit.me/v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body"<string>"{
"code": "signature_document_changed",
"detail": "signature_document_changed"
}{
"detail": "You do not have permission to perform this action."
}{
"code": "signature_field_not_found",
"detail": "signature_field_not_found"
}Electronic Signature
Download a Signature Image
Download the signature or initials a signer applied to a field of an Electronic Signature document, as a PNG.
GET
/
v3
/
session
/
{sessionId}
/
signatures
/
{nodeId}
/
fields
/
{fieldId}
/
image
/
Download a signature image
curl --request GET \
--url https://verification.didit.me/v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/ \
--header 'x-api-key: <api-key>'import requests
url = "https://verification.didit.me/v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://verification.didit.me/v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/', 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://verification.didit.me/v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$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://verification.didit.me/v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://verification.didit.me/v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://verification.didit.me/v3/session/{sessionId}/signatures/{nodeId}/fields/{fieldId}/image/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body"<string>"{
"code": "signature_document_changed",
"detail": "signature_document_changed"
}{
"detail": "You do not have permission to perform this action."
}{
"code": "signature_field_not_found",
"detail": "signature_field_not_found"
}Returns, as a PNG, the signature or initials a signer applied to a field. The path is in the field’s
A drawn signature is the image the signer drew, and it’s the image stamped into the signed PDF. A typed signature is their verified name in the handwriting style they chose, and the signed PDF carries it as text in the same style. For proof of the signature itself, use the signed document and the evidence.
A field that isn’t the signer’s, or has no applied signature or initials, returns
image_url, in signatures[].documents[].fields[], so you don’t need to build it. It needs read:sessions.
curl -L 'https://verification.didit.me/v3/session/{session_id}/signatures/{node_id}/fields/{field_id}/image/' \
-H 'x-api-key: YOUR_API_KEY' \
-o signature.png
404 with signature_field_not_found. A stored image that no longer matches its recorded SHA-256 returns 400 with signature_document_changed. After you delete the session, the route returns 404.
Related
Authorizations
Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is missing, wrong, revoked or expired; 403 means the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.
Path Parameters
The User Verification (KYC) or Business Verification (KYB) session.
Example:
"11111111-2222-3333-4444-555555555555"
The Electronic Signature step: node_id of the item in signatures[].
Example:
"feature_signature"
The field on this signer's copy, as in the field's image_url.
Response
The image.
The response is of type file.