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

ProcessesDocument

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

Document Get

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

Retrieves a specific document for a process. This endpoint retrieves detailed information for a document associated with a mortgage process. It validates that the process exists for the current broker and that the specified document belongs to the process before retrieving the document data.

Document Get › path Parameters

processUniqueId
string · uuid · required

Unique identifier of the mortgage process.

documentUniqueId
string · uuid · required

Unique identifier of the document to retrieve.

Document Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Document Get › Responses

The document details were successfully retrieved.

fileName
string

Stored file name of the document

title
string

Document title or brief description

content
string

Document content (base64)

GET/v1/processes/{processUniqueId}/document/{documentUniqueId}
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/processes/:processUniqueId/document/:documentUniqueId \
  --header 'Authorization: <string>'
shell
Example Responses
{
  "fileName": "proof_of_income.pdf",
  "title": "Proof of Income",
  "content": "<Base64_String>"
}
json
application/json

Document Update

PUT
https://api-qua-portalparceiros.bancoctt.pt
/v1/processes/{processUniqueId}/document/{documentUniqueId}

Updates an existing document for a process. This endpoint updates document metadata or content associated with a mortgage process. The request payload is mapped and validated against the process, document, and broker context before the update is persisted.

Document Update › path Parameters

processUniqueId
string · uuid · required

Unique identifier of the mortgage process.

documentUniqueId
string · uuid · required

Unique identifier of the document to update.

Document Update › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Document Update › Request Body

documentTitle
string

Document title or brief description (optional)

documentTypeID
integer · int32

Identifier of the document type (optional)

fileName
string

Stored file name for the document (optional)

documentObservations
string

Additional observations or notes about the document (optional)

documentContent
string

Document content (base64-encoded string) (optional)

Document Update › Responses

The document was successfully updated.

object
PUT/v1/processes/{processUniqueId}/document/{documentUniqueId}
curl --request PUT \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/processes/:processUniqueId/document/:documentUniqueId \
  --header 'Authorization: <string>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "documentTitle": "Proof of Income",
  "documentTypeID": 5,
  "fileName": "proof_of_income.pdf",
  "documentObservations": "Scanned copy, front and back included",
  "documentContent": "<Base64_String>"
}
'
shell
Example Request Body
{
  "documentTitle": "Proof of Income",
  "documentTypeID": 5,
  "fileName": "proof_of_income.pdf",
  "documentObservations": "Scanned copy, front and back included",
  "documentContent": "<Base64_String>"
}
json
Example Responses
{
  "operationStatus": {
    "operationStatusCode": "020101",
    "operationStatusMessage": "Process Updated successfully"
  }
}
json
application/json

Document Delete

DELETE
https://api-qua-portalparceiros.bancoctt.pt
/v1/processes/{processUniqueId}/document/{documentUniqueId}

Deletes a document from a process. This endpoint deletes a document associated with the specified mortgage process. It validates that the process and document exist and belong to the current broker before performing the deletion.

Document Delete › path Parameters

processUniqueId
string · uuid · required

Unique identifier of the mortgage process.

documentUniqueId
string · uuid · required

Unique identifier of the document to delete.

Document Delete › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Document Delete › Responses

The document was successfully deleted.

object
DELETE/v1/processes/{processUniqueId}/document/{documentUniqueId}
curl --request DELETE \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/processes/:processUniqueId/document/:documentUniqueId \
  --header 'Authorization: <string>'
shell
Example Responses
{
  "operationStatus": {
    "operationStatusCode": "020101",
    "operationStatusMessage": "Process Updated successfully"
  }
}
json
application/json

Document List

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

Retrieves all documents associated with a process. This endpoint returns a list of all documents linked to the specified mortgage process. It validates that the process exists and is accessible to the current broker before retrieving document data. The response is localized based on the language defined in the request context.

Document List › path Parameters

processUniqueId
string · uuid · required

Unique identifier of the mortgage process.

Document List › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Document List › Responses

The list of documents was successfully retrieved.

object[]
GET/v1/processes/{processUniqueId}/document
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/processes/:processUniqueId/document \
  --header 'Authorization: <string>'
shell
Example Responses
{
  "documentList": [
    {
      "documentUniqueID": "b3d9f6a1-2c34-4e9f-9f5a-1d2e3f4a5b6c",
      "title": "Proof of Income",
      "fileName": "proof_of_income.pdf",
      "statusID": 2,
      "statusDescription": "Active",
      "typeID": 924,
      "typeDescription": "Formulário DL 44 CH Jovem",
      "categoryID": 1,
      "categoryDescription": "Other",
      "observations": "Scanned copy, front and back included",
      "isMandatory": true
    }
  ]
}
json
application/json

Document Create

POST
https://api-qua-portalparceiros.bancoctt.pt
/v1/processes/{processUniqueId}/document

Creates a new document for a process. This endpoint creates a new document associated with the specified mortgage process. The request payload is mapped to a service-level model and validated against the process and broker context. Upon successful validation, the document is created and attributed to the current user.

Document Create › path Parameters

processUniqueId
string · uuid · required

Unique identifier of the mortgage process.

Document Create › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Document Create › Request Body

documentTitle
string · minLength: 1 · required

Document title or brief description

documentTypeID
integer · int32 · required

Identifier of the document type

fileName
string · minLength: 1 · required

Stored file name for the document

rejectedFile
string · minLength: 1 · required

Indicator or reason used when a file is rejected (required)

documentContent
string · minLength: 1 · required

Document content (base64-encoded string)

documentObservations
string

Additional observations or notes about the document (optional)

Document Create › Responses

The document was successfully created.

object
object
POST/v1/processes/{processUniqueId}/document
curl --request POST \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/processes/:processUniqueId/document \
  --header 'Authorization: <string>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "documentTitle": "Form DL 44",
  "documentTypeID": 924,
  "fileName": "form.pdf",
  "documentObservations": "Scanned copy, front and back included",
  "rejectedFile": "None",
  "documentContent": "<Base64_String>"
}
'
shell
Example Request Body
{
  "documentTitle": "Form DL 44",
  "documentTypeID": 924,
  "fileName": "form.pdf",
  "documentObservations": "Scanned copy, front and back included",
  "rejectedFile": "None",
  "documentContent": "<Base64_String>"
}
json
Example Responses
{
  "operationStatus": {
    "operationStatusCode": "020101",
    "operationStatusMessage": "Process Updated successfully"
  },
  "additionalData": {
    "documentUniqueID": "aa11a4b4-f234-4c03-b577-8eebd3fcc63b"
  }
}
json
application/json

ProcessesBorrowerProcessesESIS