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

Taxonomy

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

Broker Types Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/broker/types

Retrieves a paginated list of mortgage broker types. Returns all available broker type classifications in the system, such as Credit Intermediary, Non-Tied Credit Intermediary, Promoter, Client Referer, Group/Zone, and Master. Results are localized based on the authenticated user's language preference.

Broker Types Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Broker Types Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Broker Types Get › Responses

Successfully retrieved the list of broker types.

object[]
totalRows
integer · int32
GET/v1/taxonomy/broker/types
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/broker/types \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Broker Sub Types Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/broker/sub-types

Retrieves a paginated list of mortgage broker sub-types. Returns broker sub-type classifications that provide additional categorization within broker types. Sub-types are linked to their parent broker types and help further classify broker entities. Results are localized based on the authenticated user's language preference.

Broker Sub Types Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Broker Sub Types Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Broker Sub Types Get › Responses

Successfully retrieved the list of broker sub-types.

object[]
totalRows
integer · int32
GET/v1/taxonomy/broker/sub-types
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/broker/sub-types \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "mortgageBrokerTypeID": 1,
      "mortgageBrokerSubTypeID": 2,
      "mortgageBrokerSubTypeLocalizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Broker Classifications Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/broker/classifications

Retrieves a paginated list of broker classification types. Returns classification categories used to categorize mortgage brokers based on their regulatory status, operational scope, or business model. Results are localized based on the authenticated user's language preference.

Broker Classifications Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Broker Classifications Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Broker Classifications Get › Responses

Successfully retrieved the list of broker classifications.

object[]
totalRows
integer · int32
GET/v1/taxonomy/broker/classifications
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/broker/classifications \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Broker Fee Types Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/broker/fee-types

Retrieves a paginated list of broker fee types. Returns the types of fees that can be charged by mortgage brokers for their services, such as commission fees, consultation fees, or processing fees. Results are localized based on the authenticated user's language preference.

Broker Fee Types Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Broker Fee Types Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Broker Fee Types Get › Responses

Successfully retrieved the list of broker fee types.

object[]
totalRows
integer · int32
GET/v1/taxonomy/broker/fee-types
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/broker/fee-types \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Broker Statuses Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/broker/statuses

Retrieves a paginated list of broker status types. Returns the available status classifications for mortgage brokers, such as Active, Inactive, Suspended, or Pending Approval. These statuses indicate the current operational state of a broker. Results are localized based on the authenticated user's language preference.

Broker Statuses Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Broker Statuses Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Broker Statuses Get › Responses

Successfully retrieved the list of broker statuses.

object[]
totalRows
integer · int32
GET/v1/taxonomy/broker/statuses
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/broker/statuses \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Broker IVA Regimes Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/broker/iva-regimes

Retrieves a paginated list of broker IVA regimes. Returns the different IVA regimes applicable to mortgage brokers. Results are localized based on the authenticated user's language preference.

Broker IVA Regimes Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Broker IVA Regimes Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Broker IVA Regimes Get › Responses

Successfully retrieved the list of broker IVA regimes.

object[]
totalRows
integer · int32
GET/v1/taxonomy/broker/iva-regimes
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/broker/iva-regimes \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Broker Retention Regimes Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/broker/retention-regime

Retrieves a paginated list of broker retention regimes. Returns the different retention regimes applicable to mortgage brokers. Results are localized based on the authenticated user's language preference.

Broker Retention Regimes Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Broker Retention Regimes Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Broker Retention Regimes Get › Responses

Successfully retrieved the list of broker retention regimes.

object[]
totalRows
integer · int32
GET/v1/taxonomy/broker/retention-regime
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/broker/retention-regime \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Broker Extract Periodicity Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/broker/extract-periodicity

Retrieves a paginated list of broker extract periodicities. Returns the different extract periodicities applicable to mortgage brokers. Results are localized based on the authenticated user's language preference.

Broker Extract Periodicity Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Broker Extract Periodicity Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Broker Extract Periodicity Get › Responses

Successfully retrieved the list of broker extract periodicities.

object[]
totalRows
integer · int32
GET/v1/taxonomy/broker/extract-periodicity
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/broker/extract-periodicity \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Countries Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/geography/countries

Retrieves a paginated list of countries. Returns all countries available in the system with their localized names and geographic identifiers. This endpoint is typically used for populating country selection dropdowns in forms. Results are localized based on the authenticated user's language preference.

Countries Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Countries Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Countries Get › Responses

Successfully retrieved the list of countries.

object[]
totalRows
integer · int32
GET/v1/taxonomy/geography/countries
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/geography/countries \
  --header 'Authorization: <string>'
Example Responses
{ "taxonomies": [ { "countryLocalizedID": 46, "countryID": 12, "uniqueID": "FF323A4F-1069-46F4-A862-E88901512485", "name": "AFEGANISTAO", "abbreviation": "AF", "phoneCode": "93", "statusID": 2, "alphaThreeCode": "AFG", "languageID": 3 } ], "totalRows": 0 }
application/json

Country With Districts Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/geography/countries/{countryID}

Retrieves a specific country with its associated districts. Returns detailed information about a country along with a paginated list of its administrative districts. Supports filtering districts by partial name match for autocomplete scenarios. Results are localized based on the authenticated user's language preference.

Country With Districts Get › path Parameters

countryID
integer · int32 · required

The unique identifier of the country.

Country With Districts Get › query Parameters

districtPartialName
string

Optional partial name to filter districts (supports autocomplete).

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of districts to return per page (default: 150). Must be greater than 0.

Country With Districts Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Country With Districts Get › Responses

Successfully retrieved the country with its districts.

object[]
totalRows
integer · int32
object
GET/v1/taxonomy/geography/countries/{countryID}
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/geography/countries/:countryID \
  --header 'Authorization: <string>'
Example Responses
{ "taxonomies": [ { "districtID": 0, "districtName": "districtName" } ], "totalRows": 0, "countryDetails": { "countryLocalizedID": 46, "countryID": 12, "uniqueID": "FF323A4F-1069-46F4-A862-E88901512485", "name": "AFEGANISTAO", "abbreviation": "AF", "latitude": "latitude", "longitude": "longitude", "phoneCode": "93", "statusID": 2, "alphaThreeCode": "AFG", "languageID": 3, "code": "code", "numericThreeCode": 0, "originationCurrencyID": 0, "countryIBANCode": "countryIBANCode", "isEuropeanUnion": true } }
application/json

Districts Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/geography/districts

Retrieves a paginated list of districts. Returns all administrative districts available in the system with their localized names. Districts are regional subdivisions within countries, typically used for geographic organization. Results are localized based on the authenticated user's language preference.

Districts Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Districts Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Districts Get › Responses

Successfully retrieved the list of districts.

object[]
totalRows
integer · int32
GET/v1/taxonomy/geography/districts
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/geography/districts \
  --header 'Authorization: <string>'
Example Responses
{ "taxonomies": [ { "districtLocalizedID": 1, "districtID": 1, "uniqueID": "A09F1C4A-1A33-4E65-ABE6-41E03E8F123E", "countryID": 1, "name": "Aveiro", "latitude": 40.73658, "longitude": -8.504169, "statusID": 2, "code": "", "languageID": 2 } ], "totalRows": 0 }
application/json

Districts With Counties Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/geography/districts/{districtID}

Retrieves a specific district with its associated counties. Returns detailed information about a district along with a paginated list of its counties (municipalities). Supports filtering counties by partial name match for autocomplete scenarios. Results are localized based on the authenticated user's language preference.

Districts With Counties Get › path Parameters

districtID
integer · int32 · required

The unique identifier of the district.

Districts With Counties Get › query Parameters

countyPartialName
string

Optional partial name to filter counties (supports autocomplete).

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of counties to return per page (default: 150). Must be greater than 0.

Districts With Counties Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Districts With Counties Get › Responses

Successfully retrieved the district with its counties.

object[]
totalRows
integer · int32
object
GET/v1/taxonomy/geography/districts/{districtID}
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/geography/districts/:districtID \
  --header 'Authorization: <string>'
Example Responses
{ "taxonomies": [ { "countyID": 0, "countyName": "countyName" } ], "totalRows": 0, "districtDetails": { "districtLocalizedID": 1, "districtID": 1, "uniqueID": "A09F1C4A-1A33-4E65-ABE6-41E03E8F123E", "countryID": 1, "regionID": 0, "name": "Aveiro", "latitude": 40.73658, "longitude": -8.504169, "statusID": 2, "code": "", "corporateStructureID": 0, "languageID": 2 } }
application/json

Counties Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/geography/counties

Retrieves a paginated list of counties (municipalities). Returns all counties (municipalities) available in the system with their localized names. Counties are administrative subdivisions within districts. Results are localized based on the authenticated user's language preference.

Counties Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Counties Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Counties Get › Responses

Successfully retrieved the list of counties.

object[]
totalRows
integer · int32
GET/v1/taxonomy/geography/counties
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/geography/counties \
  --header 'Authorization: <string>'
Example Responses
{ "taxonomies": [ { "countyLocalizedID": 45656, "countyID": 10492, "countryID": 3, "districtID": 306, "name": "ALPIARCA", "uniqueID": "FB70B58D-66EE-45D6-BF09-DCC4505BEE56", "statusID": 2, "code": "", "languageID": 2 } ], "totalRows": 0 }
application/json

County With Parishes Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/geography/counties/{countyID}

Retrieves a specific county with its associated parishes. Returns detailed information about a county along with a paginated list of its parishes (civil parishes). Supports filtering parishes by partial name match for autocomplete scenarios. Results are localized based on the authenticated user's language preference.

County With Parishes Get › path Parameters

countyID
integer · int32 · required

The unique identifier of the county.

County With Parishes Get › query Parameters

parishPartialName
string

Optional partial name to filter parishes (supports autocomplete).

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of parishes to return per page (default: 150). Must be greater than 0.

County With Parishes Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

County With Parishes Get › Responses

Successfully retrieved the county with its parishes.

object[]
totalRows
integer · int32
object
GET/v1/taxonomy/geography/counties/{countyID}
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/geography/counties/:countyID \
  --header 'Authorization: <string>'
Example Responses
{ "taxonomies": [ { "parishID": 0, "parishName": "parishName" } ], "totalRows": 0, "countyDetails": { "countyLocalizedID": 45656, "countyID": 10492, "countryID": 3, "regionID": 0, "districtID": 306, "name": "ALPIARCA", "uniqueID": "FB70B58D-66EE-45D6-BF09-DCC4505BEE56", "latitude": "latitude", "longitude": "longitude", "statusID": 2, "code": "", "languageID": 2 } }
application/json

Parishes Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/geography/parishes

Retrieves a paginated list of parishes (civil parishes). Returns all parishes (civil parishes/freguesias) available in the system with their localized names. Parishes are the smallest administrative subdivision within counties. Results are localized based on the authenticated user's language preference.

Parishes Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Parishes Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Parishes Get › Responses

Successfully retrieved the list of parishes.

object[]
totalRows
integer · int32
GET/v1/taxonomy/geography/parishes
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/geography/parishes \
  --header 'Authorization: <string>'
Example Responses
{ "taxonomies": [ { "parishLocalizedID": 272120, "parishID": 10420, "countryID": 78269, "regionID": 3, "countyID": 284, "uniqueID": "97E91EDB-4B99-4C3B-86E2-17AD2EB1F896", "name": "", "statusID": 2, "code": "9739731", "languageID": 5 } ], "totalRows": 0 }
application/json

Document Types Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/document/types

Retrieves a paginated list of document types. Returns all document types used in the mortgage origination process, such as ID documents, proof of income, property deeds, bank statements, and other required documentation. Results are localized based on the authenticated user's language preference.

Document Types Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Document Types Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Document Types Get › Responses

Successfully retrieved the list of document types.

object[]
totalRows
integer · int32
GET/v1/taxonomy/document/types
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/document/types \
  --header 'Authorization: <string>'
Example Responses
{ "taxonomies": [ { "documentTypeLocalizedID": 817, "documentTypeID": 211, "languageID": 5, "code": "PA", "description": "PROGETTO APPROVATO", "isPublic": true, "documentCategoryID": 3, "enableQnA": true } ], "totalRows": 0 }
application/json

Document Categories Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/document/categories

Retrieves a paginated list of document categories. Returns document categories used to organize and classify documents in the mortgage process. Categories help group related document types for better organization and workflow management. Results are localized based on the authenticated user's language preference.

Document Categories Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Document Categories Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Document Categories Get › Responses

Successfully retrieved the list of document categories.

object[]
totalRows
integer · int32
GET/v1/taxonomy/document/categories
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/document/categories \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Product Purposes Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/product/purposes

Retrieves a paginated list of product purposes. Returns the main purposes for mortgage products, such as Home Purchase, Construction, Refinancing, or Home Improvements. These define the primary intent of the loan product. Results are localized based on the authenticated user's language preference.

Product Purposes Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Product Purposes Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Product Purposes Get › Responses

Successfully retrieved the list of product purposes.

object[]
totalRows
integer · int32
GET/v1/taxonomy/product/purposes
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/product/purposes \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "productPurposeLocalizedID": 81,
      "productPurposeID": 1,
      "languageID": 6,
      "description": "À DÉFINIR",
      "statusID": 2,
      "code": "TBD"
    }
  ],
  "totalRows": 0
}
application/json

Loan Purposes Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/product/loan-purposes

Retrieves a paginated list of loan purposes. Returns specific loan purposes that provide more granular classification than product purposes. These detail the exact use of loan funds within the broader product purpose category. Results are localized based on the authenticated user's language preference.

Loan Purposes Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Loan Purposes Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Loan Purposes Get › Responses

Successfully retrieved the list of loan purposes.

object[]
totalRows
integer · int32
GET/v1/taxonomy/product/loan-purposes
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/product/loan-purposes \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "loanPurposeLocalizedID": 1,
      "loanPurposeID": 1,
      "code": "ACQUISITION",
      "description": "ACQUISITION",
      "languageID": 2,
      "loanPurposeCategoryID": 1
    }
  ],
  "totalRows": 0
}
application/json

Product Schemes Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/product/schemes

Retrieves a paginated list of product schemes. Returns available product scheme classifications, such as conventional mortgages, government-backed programs, or special financing schemes. Results are localized based on the authenticated user's language preference.

Product Schemes Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Product Schemes Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Product Schemes Get › Responses

Successfully retrieved the list of product schemes.

object[]
totalRows
integer · int32
GET/v1/taxonomy/product/schemes
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/product/schemes \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Index Type Sub Categories Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/product/index-type-subcategories

Retrieves a paginated list of index type subcategories. Returns interest rate index subcategories, such as Variable, Fixed, or Mixed rate classifications. These subcategories determine how interest rates are calculated and adjusted over the loan term. Results are localized based on the authenticated user's language preference.

Index Type Sub Categories Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Index Type Sub Categories Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Index Type Sub Categories Get › Responses

Successfully retrieved the list of index type subcategories.

object[]
totalRows
integer · int32
GET/v1/taxonomy/product/index-type-subcategories
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/product/index-type-subcategories \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "indexTypeSubCategoryLocalizedID": 15,
      "indexTypeSubCategoryID": 3,
      "description": "FIXE + VARIABLE",
      "code": "F+V",
      "languageID": 6
    }
  ],
  "totalRows": 0
}
application/json

Index Types Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/product/index-types

Retrieves a paginated list of variable interest rate index types. Returns index types for variable rate products, such as Euribor 3M, 6M, 12M, or other market-based indices. Can be filtered by portfolio IDs to return only indices applicable to specific portfolios. Results are localized based on the authenticated user's language preference.

Index Types Get › query Parameters

portfolioIDList
string

Comma-separated list of portfolio IDs to filter index types (optional).

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Index Types Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Index Types Get › Responses

Successfully retrieved the list of index types.

object[]
totalRows
integer · int32
GET/v1/taxonomy/product/index-types
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/product/index-types \
  --header 'Authorization: <string>'
Example Responses
{ "taxonomies": [ { "id": 5, "description": "EURIBOR 12M", "indexTypeID": 5, "indexTypeCategoryID": 2, "indexTypeSubCategoryID": 2, "periodicityMonths": 12, "periodicityYears": 1, "statusID": 2, "type": "FLOAT", "portfolioID": 130 } ], "totalRows": 0 }
application/json

Index Type List Mixed Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/product/index-types-mixed

Retrieves a paginated list of mixed (fixed-variable) interest rate index types. Returns index types for mixed rate products that combine fixed and variable rate periods. These products typically start with a fixed rate period and then switch to a variable rate. Can be filtered by portfolio IDs to return only indices applicable to specific portfolios. Results are localized based on the authenticated user's language preference.

Index Type List Mixed Get › query Parameters

portfolioIDList
string

Comma-separated list of portfolio IDs to filter index types (optional).

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Index Type List Mixed Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Index Type List Mixed Get › Responses

Successfully retrieved the list of mixed index types.

object[]
totalRows
integer · int32
GET/v1/taxonomy/product/index-types-mixed
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/product/index-types-mixed \
  --header 'Authorization: <string>'
Example Responses
{ "taxonomies": [ { "id": 5, "description": "EURIBOR 12M", "indexTypeID": 5, "indexTypeCategoryID": 2, "indexTypeSubCategoryID": 2, "periodicityMonths": 12, "periodicityYears": 1, "statusID": 2, "type": "FLOAT", "portfolioID": 130 } ], "totalRows": 0 }
application/json

Fixed Fixed Period Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/product/fixed-fixed-period

Retrieves a paginated list of fixed-to-fixed interest rate period types. Returns fixed period options for products that maintain a fixed rate throughout the loan term or transition from one fixed period to another. Examples include 2-year, 5-year, or 10-year fixed periods. Can be filtered by portfolio IDs to return only periods applicable to specific portfolios. Results are localized based on the authenticated user's language preference.

Fixed Fixed Period Get › query Parameters

portfolioIDList
string

Comma-separated list of portfolio IDs to filter period types (optional).

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Fixed Fixed Period Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Fixed Fixed Period Get › Responses

Successfully retrieved the list of fixed-to-fixed period types.

object[]
totalRows
integer · int32
GET/v1/taxonomy/product/fixed-fixed-period
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/product/fixed-fixed-period \
  --header 'Authorization: <string>'
Example Responses
{ "taxonomies": [ { "id": 5, "description": "EURIBOR 12M", "indexTypeID": 5, "indexTypeCategoryID": 2, "indexTypeSubCategoryID": 2, "periodicityMonths": 12, "periodicityYears": 1, "statusID": 2, "type": "FLOAT", "portfolioID": 130 } ], "totalRows": 0 }
application/json

Mixed Fixed Period Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/product/mixed-fixed-period

Retrieves a paginated list of mixed fixed period types. Returns fixed period durations available for the initial fixed-rate portion of mixed-rate products. After the fixed period expires, the rate typically converts to a variable rate indexed to market rates. Can be filtered by portfolio IDs to return only periods applicable to specific portfolios. Results are localized based on the authenticated user's language preference.

Mixed Fixed Period Get › query Parameters

portfolioIDList
string

Comma-separated list of portfolio IDs to filter period types (optional).

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Mixed Fixed Period Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Mixed Fixed Period Get › Responses

Successfully retrieved the list of mixed fixed period types.

object[]
totalRows
integer · int32
GET/v1/taxonomy/product/mixed-fixed-period
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/product/mixed-fixed-period \
  --header 'Authorization: <string>'
Example Responses
{ "taxonomies": [ { "id": 5, "description": "EURIBOR 12M", "indexTypeID": 5, "indexTypeCategoryID": 2, "indexTypeSubCategoryID": 2, "periodicityMonths": 12, "periodicityYears": 1, "statusID": 2, "type": "FLOAT", "portfolioID": 130 } ], "totalRows": 0 }
application/json

Bank Charge Types Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/product/bank-charge-types

Retrieves a paginated list of bank charge types. Returns types of charges and fees that banks may apply to mortgage products, such as origination fees, appraisal fees, processing fees, or administrative charges. Results are localized based on the authenticated user's language preference.

Bank Charge Types Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Bank Charge Types Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Bank Charge Types Get › Responses

Successfully retrieved the list of bank charge types.

object[]
totalRows
integer · int32
GET/v1/taxonomy/product/bank-charge-types
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/product/bank-charge-types \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "bankChargeTypeLocalizedID": 2,
      "bankChargeTypeID": 1,
      "code": "ORG",
      "description": "Encargos Iniciais",
      "languageID": 3,
      "investorID": 50
    }
  ],
  "totalRows": 0
}
application/json

Property Typologies Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/property/typologies

Retrieves a paginated list of property typologies. Returns property type classifications used in mortgage simulations and applications, such as Apartment, House, Commercial Property, Land, or Mixed-Use Property. These typologies affect valuation, loan-to-value ratios, and eligibility criteria. Results are localized based on the authenticated user's language preference.

Property Typologies Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Property Typologies Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Property Typologies Get › Responses

Successfully retrieved the list of property typologies.

object[]
totalRows
integer · int32
GET/v1/taxonomy/property/typologies
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/property/typologies \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "simulationPropertyTypologyLocalizedID": 2,
      "simulationPropertyTypologyID": 1,
      "description": "Apartamento",
      "languageID": 3,
      "investorID": 50
    }
  ],
  "totalRows": 0
}
application/json

Entity Types Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/entity/types

Retrieves a paginated list of entity types. Returns entity type classifications used in mortgage proposals, such as Borrower, Co-Borrower, Guarantor, or Legal Representative. These define the role and relationship of individuals or entities in the mortgage application. Results are localized based on the authenticated user's language preference.

Entity Types Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Entity Types Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Entity Types Get › Responses

Successfully retrieved the list of entity types.

object[]
totalRows
integer · int32
GET/v1/taxonomy/entity/types
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/entity/types \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Identification Documents Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/entity/identification-documents

Retrieves a paginated list of identification document types. Returns valid identification document types accepted in mortgage applications, such as National ID Card, Passport, Driver's License, or Residence Permit. These are used for identity verification and compliance purposes. Results are localized based on the authenticated user's language preference.

Identification Documents Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Identification Documents Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Identification Documents Get › Responses

Successfully retrieved the list of identification document types.

object[]
totalRows
integer · int32
GET/v1/taxonomy/entity/identification-documents
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/entity/identification-documents \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Marital Statuses Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/entity/marital-statuses

Retrieves a paginated list of marital status types. Returns marital status classifications such as Single, Married, Divorced, Widowed, or in a Domestic Partnership. Marital status affects income assessment, liability evaluation, and required documentation in mortgage applications. Results are localized based on the authenticated user's language preference.

Marital Statuses Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Marital Statuses Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Marital Statuses Get › Responses

Successfully retrieved the list of marital statuses.

object[]
totalRows
integer · int32
GET/v1/taxonomy/entity/marital-statuses
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/entity/marital-statuses \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "maritalStatusLocalizedID": 20,
      "maritalStatusID": 3,
      "languageID": 3,
      "code": "M",
      "description": "Casado",
      "statusID": 2
    }
  ],
  "totalRows": 0
}
application/json

Matrimonial Regimes Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/entity/matrimonial-regimes

Retrieves a paginated list of matrimonial regime types. Returns matrimonial property regime classifications that define how assets and liabilities are shared between spouses, such as Community of Property, Separation of Property, or Participation in Acquisitions. This affects credit analysis and collateral evaluation. Results are localized based on the authenticated user's language preference.

Matrimonial Regimes Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Matrimonial Regimes Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Matrimonial Regimes Get › Responses

Successfully retrieved the list of matrimonial regimes.

object[]
totalRows
integer · int32
GET/v1/taxonomy/entity/matrimonial-regimes
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/entity/matrimonial-regimes \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Residence Types Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/entity/residence-types

Retrieves a paginated list of residence types. Returns residence type classifications such as Owner-Occupied, Rented, Living with Family, or Company-Provided Housing. This information is used for expense assessment and determining housing cost stability. Results are localized based on the authenticated user's language preference.

Residence Types Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Residence Types Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Residence Types Get › Responses

Successfully retrieved the list of residence types.

object[]
totalRows
integer · int32
GET/v1/taxonomy/entity/residence-types
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/entity/residence-types \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Genders Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/entity/genders

Retrieves a paginated list of gender types. Returns gender classifications such as Male, Female, or Other/Prefer not to say. This information is collected for demographic analysis and regulatory compliance. Results are localized based on the authenticated user's language preference.

Genders Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Genders Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Genders Get › Responses

Successfully retrieved the list of genders.

object[]
totalRows
integer · int32
GET/v1/taxonomy/entity/genders
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/entity/genders \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "genderLocalizedID": 10,
      "genderID": 1,
      "languageID": 1,
      "code": "M",
      "description": "Male",
      "statusID": 0
    }
  ],
  "totalRows": 0
}
application/json

Professions Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/entity/professions

Retrieves a paginated list of profession types. Returns profession/occupation classifications used to categorize borrowers' employment, such as Employee, Self-Employed Professional, Business Owner, Retired, or Student. Profession type affects income verification requirements and risk assessment. Results are localized based on the authenticated user's language preference.

Professions Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Professions Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Professions Get › Responses

Successfully retrieved the list of professions.

object[]
totalRows
integer · int32
GET/v1/taxonomy/entity/professions
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/entity/professions \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "mortgageProposalProfessionLocalizedID": 17,
      "mortgageProposalProfessionID": 17,
      "languageID": 2,
      "description": "Administrative Staff - Casino Bank Employees and Other Betting Employees",
      "isVisible": true
    }
  ],
  "totalRows": 0
}
application/json

Employment Contract Types Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/entity/employment-contract-types

Retrieves a paginated list of employment contract type Returns employment contract type classifications such as Permanent Contract, Fixed-Term Contract, Temporary/Seasonal, Independent Contractor, or No Contract. Contract type affects income stability assessment and required documentation for employment verification. Results are localized based on the authenticated user's language preference.

Employment Contract Types Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Employment Contract Types Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Employment Contract Types Get › Responses

Successfully retrieved the list of employment contract types.

object[]
totalRows
integer · int32
GET/v1/taxonomy/entity/employment-contract-types
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/entity/employment-contract-types \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Employment Situations Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/entity/employment-situations

Retrieves a paginated list of employment situation types. Returns employment situation classifications such as Employed, Self-Employed, Unemployed, Retired, Student, or Homemaker. This categorizes the borrower's current employment status and affects eligibility and income assessment. Results are localized based on the authenticated user's language preference.

Employment Situations Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Employment Situations Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Employment Situations Get › Responses

Successfully retrieved the list of employment situations.

object[]
totalRows
integer · int32
GET/v1/taxonomy/entity/employment-situations
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/entity/employment-situations \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Employment Department Positions Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/entity/employment-department-positions

Retrieves a paginated list of employment department position types. Returns organizational position/department classifications within employment structures, such as Executive/Management, Technical/Professional, Administrative, or Operational roles. This information helps assess income level and employment stability. Results are localized based on the authenticated user's language preference.

Employment Department Positions Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Employment Department Positions Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Employment Department Positions Get › Responses

Successfully retrieved the list of employment department positions.

object[]
totalRows
integer · int32
GET/v1/taxonomy/entity/employment-department-positions
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/entity/employment-department-positions \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Key Borrower Relations Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/entity/key-borrower-relations

Retrieves a paginated list of key borrower relations. Results are localized based on the authenticated user's language preference.

Key Borrower Relations Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Key Borrower Relations Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Key Borrower Relations Get › Responses

Successfully retrieved the list of key borrower relations.

object[]
totalRows
integer · int32
GET/v1/taxonomy/entity/key-borrower-relations
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/entity/key-borrower-relations \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Proposal Cancel Reasons Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/proposal/cancel-reasons

Retrieves a paginated list of proposal cancellation reasons. Returns standardized reasons for canceling mortgage proposals, such as Client Request, Failed Credit Check, Incomplete Documentation, Better Offer Found, or Property Issues. These reasons are used for tracking and analytics purposes. Results are localized based on the authenticated user's language preference.

Proposal Cancel Reasons Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Proposal Cancel Reasons Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Proposal Cancel Reasons Get › Responses

Successfully retrieved the list of proposal cancel reasons.

object[]
totalRows
integer · int32
GET/v1/taxonomy/proposal/cancel-reasons
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/proposal/cancel-reasons \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Proposal Reject Reasons Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/proposal/reject-reasons

Retrieves a paginated list of proposal rejection reasons. Returns standardized reasons for rejecting mortgage proposals by underwriters or lenders, such as Insufficient Income, High Debt-to-Income Ratio, Poor Credit History, Inadequate Collateral, or Policy Non-Compliance. Used for decision tracking and applicant feedback. Results are localized based on the authenticated user's language preference.

Proposal Reject Reasons Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Proposal Reject Reasons Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Proposal Reject Reasons Get › Responses

Successfully retrieved the list of proposal reject reasons.

object[]
totalRows
integer · int32
GET/v1/taxonomy/proposal/reject-reasons
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/proposal/reject-reasons \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Simulation Reject Reasons Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/proposal/simulation-reject-reasons

Retrieves a paginated list of simulation rejection reasons. Returns standardized reasons for rejecting mortgage simulations during preliminary analysis, such as Exceeds Maximum LTV, Insufficient Affordability, Outside Age Limits, or Product Not Available. Used for pre-qualification filtering and user guidance. Results are localized based on the authenticated user's language preference.

Simulation Reject Reasons Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Simulation Reject Reasons Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Simulation Reject Reasons Get › Responses

Successfully retrieved the list of simulation reject reasons.

object[]
totalRows
integer · int32
GET/v1/taxonomy/proposal/simulation-reject-reasons
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/proposal/simulation-reject-reasons \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

Workflow Phases Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/workflow/phases

Retrieves a paginated list of workflow phases. Returns the major phases in the mortgage origination workflow, such as Simulation, Pre-Analysis, Documentation, Underwriting, Approval, and Closing. These phases represent high-level stages in the loan processing lifecycle. Results are localized based on the authenticated user's language preference.

Workflow Phases Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Workflow Phases Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Workflow Phases Get › Responses

Successfully retrieved the list of workflow phases.

object[]
totalRows
integer · int32
GET/v1/taxonomy/workflow/phases
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/workflow/phases \
  --header 'Authorization: <string>'
Example Responses
{ "taxonomies": [ { "workflowPhaseLocalizedID": 23, "workflowPhaseID": 1, "qualifiedName": "1- Criação de Proposta", "code": "CP", "description": "1- Creación de Propuesta", "workflowPhaseNumber": 1, "workflowTypeID": 2, "languageID": 4 } ], "totalRows": 0 }
application/json

Workflow States Simulation Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/workflow/states/simulation

Retrieves a paginated list of workflow states for mortgage simulations. Returns detailed workflow states specific to the simulation process, such as Draft, Submitted, Under Review, Approved, Rejected, or Expired. These states track the progression and current status of mortgage simulations through the workflow. Results are localized based on the authenticated user's language preference.

Workflow States Simulation Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Workflow States Simulation Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Workflow States Simulation Get › Responses

Successfully retrieved the list of simulation workflow states.

object[]
totalRows
integer · int32
GET/v1/taxonomy/workflow/states/simulation
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/workflow/states/simulation \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "workflowStateID": 6,
      "workflowStateTypeID": 2,
      "workflowTypeID": 1,
      "code": "E",
      "description": "Caducado"
    }
  ],
  "totalRows": 0
}
application/json

Workflow States Proposal Get

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/workflow/states/proposal

Retrieves a paginated list of workflow states for mortgage proposals. Returns detailed workflow states specific to the proposal process, such as Draft, Pending Documentation, In Underwriting, Conditionally Approved, Approved, Rejected, or Withdrawn. These states track the progression and current status of formal mortgage proposals through the workflow. Results are localized based on the authenticated user's language preference.

Workflow States Proposal Get › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Workflow States Proposal Get › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Workflow States Proposal Get › Responses

Successfully retrieved the list of proposal workflow states.

object[]
totalRows
integer · int32
GET/v1/taxonomy/workflow/states/proposal
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/workflow/states/proposal \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "workflowStateID": 6,
      "workflowStateTypeID": 2,
      "workflowTypeID": 1,
      "code": "E",
      "description": "Caducado"
    }
  ],
  "totalRows": 0
}
application/json

Retrieves a paginated list of notification types

GET
https://api-qua-portalparceiros.bancoctt.pt
/v1/taxonomy/notification/types

Retrieves a paginated list of notification types.

Retrieves a paginated list of notification types › query Parameters

page
integer · int32

The page number for pagination (default: 1). Must be greater than 0.

limit
integer · int32

The maximum number of items to return per page (default: 150). Must be greater than 0.

Retrieves a paginated list of notification types › Headers

Authorization
string · required

Bearer token for authentication. Format: Bearer {token}

Retrieves a paginated list of notification types › Responses

Successfully retrieved the list of notification types.

object[]
totalRows
integer · int32
GET/v1/taxonomy/notification/types
curl --request GET \
  --url https://api-qua-portalparceiros.bancoctt.pt/v1/taxonomy/notification/types \
  --header 'Authorization: <string>'
Example Responses
{
  "taxonomies": [
    {
      "id": 2,
      "localizedID": 17,
      "description": "Taxonomy Description",
      "languageID": 1033
    }
  ],
  "totalRows": 0
}
application/json

SimulationsMessages