Skip to main content
POST
/
v1
/
customers
/
upload
Upload Document
curl --request POST \
  --url https://sandbox.api.fin.com/v1/customers/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form customer_id=659fd1e8-b7db-4276-8c0f-33b354fe68ef \
  --form passport='@example-file' \
  --form poa='@example-file' \
  --form poi='@example-file' \
  --form [any_field_name]='@example-file'
{
  "data": {
    "files": [
      {
        "passport": "/CwW9PHhP_Germany-passport.jpg",
        "poa": "/KVdLfqjR_germany-poa-green.jpg"
      }
    ]
  }
}

​
Allowed File Types

  • PDF
  • JPG / JPEG
  • PNG
Files should be uploaded as separate form fields with arbitrary names. You can use any field name for files (e.g., passport, poa, poi, file1, document1, etc.). The field name you use will be returned as the key in the response.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Obtain token from /v1/oauth/token endpoint

Body

multipart/form-data
​
customer_id
string<uuid>

Unique identifier for the customer

Example:

"659fd1e8-b7db-4276-8c0f-33b354fe68ef"

​
passport
file

Document file (can use any field name such as passport, poa, poi, etc.)

​
poa
file

Document file (can use any field name such as passport, poa, poi, etc.)

​
poi
file

Document file (can use any field name such as passport, poa, poi, etc.)

​
[any_field_name]
file

Document files to upload (can use any field name)

Response

Documents uploaded successfully

​
data
object