Skip to main content
POST
/
api
/
v3
/
upload
/
sdk
/
{short_id}
Upload document
curl --request POST \
  --url https://api.dataspike.io/api/v3/upload/sdk/{short_id} \
  --header 'Content-Type: multipart/form-data' \
  --header 'ds-api-token: <api-key>' \
  --form side=front \
  --form issued_country=AAA \
  --form file=@example-file
{
  "document_id": "01827ed4-c928-7a3c-9a30-7ab7cc169d11",
  "detected_document_type": "passport",
  "detected_document_side": "front",
  "detected_two_side_document": true,
  "detected_country": "FI"
}

Authorizations

​
ds-api-token
string
header
required

Path Parameters

​
short_id
string
required

Existing Short Veririfcation Id

Example:

"VDBA1B2EA6A28A7D2"

Body

​
file
file
required
​
document_type
enum<string>
required

Possible document type Document type of uploaded file. Can be just poi to turn on auto detection algorithm. In that case we return detected_document_type in response.

​
side
enum<string>

Possible document side

Available options:
front,
back
​
issued_country
string<ISO 3166-1 alpha-3>

Country issued document in ISO 3166-1 alpha-3 format.

Example:

"AAA"

Response

Document Id for an uploaded file

​
document_id
string<uuid>
Example:

"01827ed4-c928-7a3c-9a30-7ab7cc169d11"

​
detected_document_type
enum<string>

Possible document type

Available options:
passport,
id_card,
residence_permit,
driver_license,
poa,
selfie,
liveness_photo,
kyb_certificate_of_incorporation,
kyb_ownership_document
​
detected_document_side
enum<string>

Possible document side

Available options:
front,
back
​
detected_two_side_document
boolean
​
detected_country
string

Country in ISO 31661-1 alpha-2 code

Example:

"FI"