Skip to navigation

Upload a document for an EDD request of a legal entity

Beta

Stores one document answering a DOCUMENT_UPLOAD question of the open enhanced due diligence (EDD) request of a legal entity, and returns an opaque handle. Reference the handle from POST /rest/legal-entities/{legal_entity_id}/kyb/edd. Handles are bound to the legal entity, the EDD request and the question, usable once, and expire after 24 hours if unused. The file itself is never returned.

Token scopes: legal-entity:write

Beta: this version requires the X-Beta: true request header and its contract may change before it is promoted to stable. It is scheduled to become stable on 2027-01-14.

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

OR
AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Path parameters

legal_entity_idstringRequiredformat: "uuid"

Public id of the legal entity. The entity must belong to the authenticated organization; any other id answers 404.

Headers

X-BetaenumRequiredDefaults to true

Opts in to the beta version of this endpoint. Must be true.

Allowed values:

Request

One document answering a DOCUMENT_UPLOAD question of the open EDD request.

dataobjectRequired

Response

The document was stored. Use the returned handle in an EDD answer.
dataobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
415
Unsupported Media Type Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error