Skip to navigation

Upload a KYB document for a legal entity

Beta

Stores one KYB document (a company document, a Proof of Authority, or one side of an identity document or selfie for a person of significant control) for a legal entity and returns an opaque handle. Reference the handle from POST /rest/legal-entities/{legal_entity_id}/kyb. Handles are bound to the legal entity, 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-01.

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.deel.training/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.

Request

One KYB document and the type it should be recorded as.
dataobjectRequired

Response

The document was stored and registered for verification. Use the returned handle in a KYB submission.
dataobject

Errors

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