BCTT Partners Portal API - Developer Portal
  • Documentation
  • API Reference
Authentication
    Authenticatepost
Partners
    Callback UpdateputCallback DeletedeleteCallback ListgetCallback Echopost
Processes
    Process DetailgetProcess UpdateputProcess ListgetProcess CreatepostProcess SubmitpostProcess Canceldelete
ProcessesBorrower
    Borrower GetgetBorrower UpdateputBorrower DeletedeleteBorrower ListgetBorrower Createpost
ProcessesDocument
    Document GetgetDocument UpdateputDocument DeletedeleteDocument ListgetDocument Createpost
ProcessesESIS
    Process ESIS GetgetProcess ESIS Emailget
ProcessesMessage
    Processes Message ListgetProcesses Message Createpost
ProcessesProperty
    Property ListgetProperty Updateput
Simulations
    Simulation ListgetSimulation CreatepostSimulation DetailgetSimulation CanceldeleteSimulation UpdatepatchSimulation Validatepost
SimulationsESIS
    Simulation ESIS GetgetSimulation ESIS Emailget
SimulationsMessages
    Simulations Message ListgetSimulations Message Createpost
Taxonomy
    Broker Types GetgetBroker Sub Types GetgetBroker Classifications GetgetBroker Fee Types GetgetBroker Statuses GetgetBroker IVA Regimes GetgetBroker Retention Regimes GetgetBroker Extract Periodicity GetgetCountries GetgetCountry With Districts GetgetDistricts GetgetDistricts With Counties GetgetCounties GetgetCounty With Parishes GetgetParishes GetgetDocument Types GetgetDocument Categories GetgetProduct Purposes GetgetLoan Purposes GetgetProduct Schemes GetgetIndex Type Sub Categories GetgetIndex Types GetgetIndex Type List Mixed GetgetFixed Fixed Period GetgetMixed Fixed Period GetgetBank Charge Types GetgetProperty Typologies GetgetEntity Types GetgetIdentification Documents GetgetMarital Statuses GetgetMatrimonial Regimes GetgetResidence Types GetgetGenders GetgetProfessions GetgetEmployment Contract Types GetgetEmployment Situations GetgetEmployment Department Positions GetgetKey Borrower Relations GetgetProposal Cancel Reasons GetgetProposal Reject Reasons GetgetSimulation Reject Reasons GetgetWorkflow Phases GetgetWorkflow States Simulation GetgetWorkflow States Proposal GetgetRetrieves a paginated list of notification typesget
Schemas
Partners Portal API
Partners Portal API

ProcessesESIS

Endpointhttps://api-qua-portalparceiros.bancoctt.pt

Process ESIS Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/processes/{processUniqueId}/esis

Retrieves the ESIS document for a process. This endpoint generates and retrieves the ESIS for the specified mortgage process using the current iteration associated with the process. The generation can optionally ignore validation rules to comply with Law 24/2023 requirements. If ESIS generation fails, a validation error is returned. (Currently only portuguese works.)

Process ESIS Get › path Parameters

processUniqueId
string · uuid · required

Unique identifier of the mortgage process.

Process ESIS Get › query Parameters

ignoreRules
boolean · required

Indicates whether ESIS generation rules (Law 24/2023) should be ignored.

Process ESIS Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Process ESIS Get › Responses

The ESIS document was successfully generated.

esis
string

ESIS file in Base64 string format

GET/v1/processes/{processUniqueId}/esis
curl --request GET \
  --url 'https://api-qua-portalparceiros.bancoctt.pt/v1/processes/:processUniqueId/esis?ignoreRules=%3Cbool%3E' \
  --header 'Authorization: <string>'
shell
Example Responses
{
  "esis": "<Base64_String>"
}
json
application/json

Process ESIS Email

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/processes/{processUniqueId}/esis/email

Sends the ESIS document for a process by email. This endpoint generates the ESIS for the specified mortgage process and sends it to the provided email address. ESIS generation is performed using the current process iteration and may optionally ignore validation rules. If ESIS generation or email delivery fails, a validation error is returned. (Currently only portuguese works)

Process ESIS Email › path Parameters

processUniqueId
string · uuid · required

Unique identifier of the mortgage process.

Process ESIS Email › query Parameters

ignoreRules
boolean · required

Indicates whether ESIS generation rules (Law 24/2023) should be ignored.

sendAddress
string · required

Email address to which the ESIS will be sent.

Process ESIS Email › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Process ESIS Email › Responses

The ESIS was successfully sent by email.

object
GET/v1/processes/{processUniqueId}/esis/email
curl --request GET \
  --url 'https://api-qua-portalparceiros.bancoctt.pt/v1/processes/:processUniqueId/esis/email?ignoreRules=%3Cbool%3E&sendAddress=%3Cstring%3E' \
  --header 'Authorization: <string>'
shell
Example Responses
{
  "operationStatus": {
    "operationStatusCode": "020101",
    "operationStatusMessage": "Process Updated successfully"
  }
}
json
application/json

ProcessesDocumentProcessesMessage