Skip to main content
POST
/
api
/
partner
/
v2
/
users
/
{userId}
/
documents
/
sign
cURL
curl --request POST \
  --url https://staging-api.capa.fi/api/partner/v2/users/{userId}/documents/sign \
  --header 'Content-Type: application/json' \
  --header 'partner-api-key: <partner-api-key>' \
  --data '
{
  "country": "MX"
}
'
{
  "success": true,
  "data": {
    "url": "<string>"
  }
}
Initiates the document signing process for a user. Returns a URL where the user can sign required agreements for a specific country.

​
Important Notes

  • Only INDIVIDUAL users can request document signatures.
  • The user must be KYC-verified before requesting signatures.
  • Users who have already signed documents cannot sign again.

​
Error Codes

​
Common Errors

HTTP StatusCodeMessage
401UNAUTHORIZED”API Key is missing”
401UNAUTHORIZED”Invalid API Key format”
401UNAUTHORIZED”Invalid API Key”
403INVALID_PARTNER_FLOW”The partner has an invalid flow.”

​
User Ownership Errors

HTTP StatusCodeMessage
401UNAUTHORIZED”Partner information is required for this operation”
401UNAUTHORIZED”User is not associated with the partner”

​
Endpoint-Specific Errors

HTTP StatusCodeMessage
400INVALID_USER_INPUT_ERROR”Invalid User Input”
400BAD_REQUEST”Country not supported”
400BAD_REQUEST”User must be of type INDIVIDUAL to request document signatures”
400BAD_REQUEST”User already has signed documents”
400USER_NOT_VERIFIED_ERROR”User identity verification not verified”
400BAD_REQUEST”User authentication method is not email”
400BAD_REQUEST”User identity verification missing name”
404NOT_FOUND_ERROR”Failed to find user identity verification”
404NOT_FOUND_ERROR”No active templates found”
404NOT_FOUND_ERROR”Requested User was not found”
500INTERNAL_SERVER_ERROR”Document signature provider failure”

Headers

​
partner-api-key
string
required

Api key for the affiliated partner that is performing the request

Path Parameters

​
userId
string
required

The user ID

Body

application/json
​
country
enum<string>
required

The country code for the document signature request

@description The country must be a valid ISO 3166-1 alpha-2 country code, see: @link https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2

Available options:
MX,
DO,
US,
AT,
BE,
BG,
HR,
CY,
CZ,
DK,
EE,
FI,
FR,
DE,
GR,
HU,
IE,
IT,
LV,
LT,
LU,
MT,
NL,
PL,
PT,
RO,
SK,
SI,
ES,
SE,
IS,
LI,
NO,
CH,
GB,
MC,
SM,
AD,
VA
Example:

"MX"

Response

201 - application/json
​
success
boolean
Example:

true

​
data
object