--- updatedAt: 2026-01-29T09:03:04.000Z agentTools: projectIndex: https://devportal.fintensy.com/llms.txt --- # Create signer(s) contexts Send a signing context, including details about the reference of the case and the signers involved # OpenAPI definition ```json { "openapi": "3.0.3", "info": { "title": "Digital Signature API", "description": "API definition for the Digital Signature services exposed by Fintensy and consumed by Record Credits.", "version": "1.0.0", "contact": { "name": "Fintensy API Team", "url": "https://www.fintensy.com" } }, "servers": [ { "url": "https://{{base_url}}", "description": "ACC – Application service (DEV)" }, { "url": "https://record-identity-dev.digitalisedsvices.com", "description": "ACC – Identity service (DEV)" }, { "url": "https://record-platform-dev.digitalisedsvices.com", "description": "ACC – Platform service (DEV)" }, { "url": "https://record-app.digitalisedsvices.com", "description": "PRD – Application service" }, { "url": "https://record-identity.digitalisedsvices.com", "description": "PRD – Identity service" }, { "url": "https://record-platform.digitalisedsvices.com", "description": "PRD – Platform service" } ], "paths": { "/api/signer-contexts": { "post": { "description": "", "operationId": "get_apisigner-contexts", "responses": { "200": { "description": "Successfully created signer(s) context" }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "number", "description": "Internal functional error code returned." }, "message": { "type": "string", "description": "Error message in plain text" }, "errors": { "type": "object", "description": "Error details object" } }, "required": [ "code", "message", "errors" ] } } } }, "401": { "description": "Unauthorized", "content": {} }, "500": { "description": "Internal Server Error", "content": {} } }, "parameters": [], "x-readme": { "code-samples": [ { "code": "{\n \"reference\": \"E25878\",\n \"valid_to\": \"2026-07-01T10:55:24.000Z\",\n \"branch_external_reference\": \"442654\",\n \"loan_amount\": \"40000.00\",\n \"loan_currency\": \"EUR\",\n \"loan_duration\": \"60\",\n \"loan_created_at\": \"2025-08-03T00:00:00.000Z\",\n \"signers\": [\n {\n \"email\": \"john.doe@example.com\",\n \"mobile_phone_number\": \"32470112233\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"gender\": \"M\",\n \"language\": \"nl\",\n \"national_identification_number\": \"00010112377\",\n \"role\": 1\n },\n {\n \"email\": \"jacque@example.com\",\n \"mobile_phone_number\": \"32470112234\",\n \"first_name\": \"Jacques\",\n \"last_name\": \"Troe\",\n \"gender\": \"M\",\n \"language\": \"nl\",\n \"national_identification_number\": \"00010112347\",\n \"role\": 2\n }\n ]\n}", "language": "json", "name": "" } ], "samples-languages": [ "json" ] }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "reference": { "type": "string", "description": "Unique external reference ID of the loan / signing context. Example: E25878.", "default": "" }, "valid_to": { "type": "string", "description": "Expiration datetime of the signing context, in ISO 8601 UTC format", "format": "date-time", "default": "" }, "branch_external_reference": { "type": "string", "description": "Partner branch or broker identifier. Example: 442654.", "default": "" }, "loan_amount": { "type": "number", "description": "Total loan amount, expressed as a decimal number", "default": "", "format": "float" }, "loan_currency": { "type": "string", "description": "ISO 4217 3-letter loan currency code", "default": "" }, "loan_duration": { "type": "number", "description": "Loan duration expressed in number of months", "default": "" }, "loan_created_at": { "type": "string", "format": "date-time", "description": "Datetime when the loan was created in the partner system, ISO 8601 UTC", "default": "" }, "signers": { "type": "object", "description": "List of persons required to sign the contract", "properties": { "email": { "type": "string", "description": "Email address of the signer", "default": "" }, "mobile_phone_number": { "type": "string", "description": "Signer mobile phone number in international (E.164) format", "default": "" }, "first_name": { "type": "string", "description": "Signer’s first name", "default": "" }, "last_name": { "type": "string", "default": "", "description": "Signer’s last name" }, "gender": { "type": "string", "description": "Signer’s gender code if available", "default": "M", "enum": [ "F", "M" ] }, "language": { "type": "string", "description": "Preferred language of the signer, ISO 2-letter code", "default": "" }, "national_identification_number": { "type": "string", "description": "National identification number used for identity verification", "default": "" }, "role": { "type": "number", "description": "Signer role within the contract. Example: \n Unknown = 0,\n Primary = 1,\n Secondary = 2,\n Broker = 3\n", "default": "", "enum": [ 0, 1, 2, 3 ] } }, "required": [ "email", "mobile_phone_number", "first_name", "last_name", "national_identification_number", "role", "gender", "language" ] } }, "required": [ "reference", "valid_to", "branch_external_reference", "signers", "loan_amount", "loan_currency", "loan_duration", "loan_created_at" ] }, "examples": { "Create signer(s) context": { "summary": "Create signer(s) context", "value": { "reference": "E25878", "valid_to": "2026-07-01T10:55:24.000Z", "branch_external_reference": "442654", "loan_amount": "40000.00", "loan_currency": "EUR", "loan_duration": "60", "loan_created_at": "2025-08-03T00:00:00.000Z", "signers": [ { "email": "john.doe@example.com", "mobile_phone_number": "32470112233", "first_name": "John", "last_name": "Doe", "gender": "M", "language": "nl", "national_identification_number": "00010112377", "role": 1 }, { "email": "jacques@example.com", "mobile_phone_number": "32470112234", "first_name": "Jacques", "last_name": "Troe", "gender": "M", "language": "nl", "national_identification_number": "00010112347", "role": 2 } ] } } } } } } } } }, "security": [], "x-readme": {} } ```