Skip to main content
POST
/
v1
/
beneficiaries
/
{beneficiary_id}
/
documents
Upload Beneficiary Documents
curl --request POST \
  --url https://sandbox.api.fin.com/v1/beneficiaries/{beneficiary_id}/documents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form doc1='@example-file'
{
  "data": {
    "files": [
      {
        "invoice1": "/wKbvfH5E_Invoice.pdf"
      },
      {
        "invoice2": "/XUOdWacK_Invoice.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., 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

Path Parameters

​
beneficiary_id
string<uuid>
required

Unique identifier for the beneficiary

Body

multipart/form-data
​
doc1
file

Document file to upload (can be repeated multiple times for multiple files)

Response

200 - application/json

OK - Documents uploaded successfully

​
data
object