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 file1='@example-file' \
  --form file_foo='@example-file' \
  --form file_bar='@example-file' \
  --form [what_ever_you_want]='@example-file'
{
  "data": {
    "files": [
      {
        "file1": "/AbAcQ4hn_0652746727637.pdf"
      }
    ]
  }
}

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., file1, file2, document1, etc.).

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"

file1
file

Document files to upload (can use any field name)

file_foo
file

Document files to upload (can use any field name)

file_bar
file

Document files to upload (can use any field name)

[what_ever_you_want]
file

Document files to upload (can use any field name)

Response

Documents uploaded successfully

data
object