Skip to content

Mifundo Consumer API 1.0 (1.0)

Mifundo Consumer API.

Download OpenAPI description
MCA.json
MCA.yaml
Languages
Servers
Mock server
https://doc.mifundo.com/_mock/mca
Production API
https://api.mifundo.com/mca
Test API
https://apitest.mifundo.com/mca

AccountStatements

Operations

Attachments

Operations

Categorizations

Operations

Consumer

Operations

Court

Operations

Immovables

Operations

LegalEntities

Operations

Metrics

Operations

NegativeTradelines

Operations

PersonDetails

Operations

PositiveTradelines

Operations

RegistryIncomes

Operations

Scores

Operations

Sessions

Session is a collection of inputs for retrieving various sets of information

Operations

Creates a new session

Request

Defines search input for a person and returns a session ID based on which results can be requested

Security
keycloakAuthLive or keycloakAuthTest
Bodyapplication/json
subjectEmailnull or stringrequired

Data Subject email. This is used to contact the Data Subject for getting Consents.

queryParametersArray of objects or null(QueryParameter)

A collection of query parameters. At least one query parameter is required.

curl -i -X POST \
  https://doc.mifundo.com/_mock/mca/v1/sessions \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "subjectEmail": "john.doe@example.com",
    "queryParameters": [
      {
        "countryCode": "GBR",
        "dataPackages": [
          "SCORE",
          "IDENTIFICATION"
        ]
      }
    ]
  }'

Responses

Created

Bodyapplication/json
idstring(uuid)required

Unique Session identifier. Used in subsequent requests to fetch Session related data.

createdAtUtcstring(date-time)required

Session creation time in UTC.

createdByNamenull or string

Agent name who created the Session.

organizationalUnitNamenull or string

Organizational unit name of the agent who created the Session.

subjectEmailnull or stringrequired

Data Subject email. This is used to contact the Data Subject for getting Consents

subjectFullNamenull or string

Data Subject full name. Field will stay empty until subject has completed the identification step.

customerInputDeadlineUtcnull or string(date-time)

Deadline by which the customer is expected to provide input. If Data Subject hasn't provided the input by that time, new Session should be created.

customerProgressStatusstringrequired

Current Session status.

Enum ValueDescription
DELIVERY_FAILED

Delivery to the customer failed.

WAITING_FOR_CUSTOMER

Awaiting action or input from the customer.

COMPLETED_BY_CUSTOMER

Customer has completed the required steps.

EXPIRED

The customer's opportunity or session expired.

queryParametersArray of objects or null(QueryParameter)required

Session input elements

queryParameters[].​countryCodenull or stringrequired

ISO 3166-1 alpha-3 code representing the country for which the customer is requesting information about the Data Subject.

queryParameters[].​dataPackagesArray of strings or null(DataPackage)

List of data packages requested for the specified country.

Enum ValueDescription
CREDIT_HISTORY

Historical credit data about the customer.

SCORE

Credit score calculated based on customer data.

BANK_ACCOUNT_CATEGORIZATION

Categorization of transactions in the customer's bank account.

IDENTIFICATION

Identification documents or data of the customer.

customerInputDeadlineExtendableUntilUtcnull or string(date-time)
dataPackageUpgradableUntilUtcnull or string(date-time)
Response
application/json
{
  "id": "3090e92c-1f3e-4032-a043-0ac46b66fae8",
  "createdAtUtc": "2025-03-12T00:00:00+00:00",
  "createdByName": "Wilford Lowery",
  "organizationalUnitName": null,
  "subjectEmail": "john.doe@example.com",
  "subjectFullName": "John Doe",
  "customerInputDeadlineUtc": "2025-03-26T00:00:00+00:00",
  "customerProgressStatus": "WAITING_FOR_CUSTOMER",
  "queryParameters": [
    { … }
  ],
  "customerInputDeadlineExtendableUntilUtc": null,
  "dataPackageUpgradableUntilUtc": null
}

Search for existing sessions

Request

Gets all sessions optionally filtered by request parameters

Security
keycloakAuthLive or keycloakAuthTest
Query
SubjectEmailstring

Email address of the data subject used to filter sessions.

SubjectFullNamestring

Full name of the data subject used to filter sessions.

CountryCodestring

ISO 3166-1 alpha-3 code representing the country related to the sessions.

CreatedFromUtcstring(date)

Start date (UTC) for filtering sessions by creation date.

CreatedToUtcstring(date)

End date (UTC) for filtering sessions by creation date.

CustomerProgressStatusstring

Specifies the progress status of a customer in a process.

Enum ValueDescription
DELIVERY_FAILED

Delivery to the customer failed.

WAITING_FOR_CUSTOMER

Awaiting action or input from the customer.

COMPLETED_BY_CUSTOMER

Customer has completed the required steps.

EXPIRED

The customer's opportunity or session expired.

CreatedByNamestring

Name of the person who created the session.

OrganizationalUnitNamestring

Name of the organizational unit responsible for the session.

Skipinteger(int32)

Number of records to skip when retrieving paginated results.

Takeinteger(int32)

Number of records to retrieve in the paginated result.

curl -i -X GET \
  'https://doc.mifundo.com/_mock/mca/v1/sessions?SubjectEmail=string&SubjectFullName=string&CountryCode=string&CreatedFromUtc=2019-08-24&CreatedToUtc=2019-08-24&CustomerProgressStatus=DELIVERY_FAILED&CreatedByName=string&OrganizationalUnitName=string&Skip=0&Take=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OK

Bodyapplication/json
sessionsArray of objects or null(SessionItem)

List of sessions matching the query parameters.

pagingnull

Paging details for the sessions response.

Response
application/json
{
  "sessions": null,
  "paging": {
    "totalCount": 0,
    "skip": null,
    "take": null
  }
}

Get session by ID

Request

Gets a session by ID

Security
keycloakAuthLive or keycloakAuthTest
Path
sessionIdstring(uuid)required
curl -i -X GET \
  'https://doc.mifundo.com/_mock/mca/v1/sessions/{sessionId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OK

Bodyapplication/json
idstring(uuid)required

Unique Session identifier. Used in subsequent requests to fetch Session related data.

createdAtUtcstring(date-time)required

Session creation time in UTC.

createdByNamenull or string

Agent name who created the Session.

organizationalUnitNamenull or string

Organizational unit name of the agent who created the Session.

subjectEmailnull or stringrequired

Data Subject email. This is used to contact the Data Subject for getting Consents

subjectFullNamenull or string

Data Subject full name. Field will stay empty until subject has completed the identification step.

customerInputDeadlineUtcnull or string(date-time)

Deadline by which the customer is expected to provide input. If Data Subject hasn't provided the input by that time, new Session should be created.

customerProgressStatusstringrequired

Current Session status.

Enum ValueDescription
DELIVERY_FAILED

Delivery to the customer failed.

WAITING_FOR_CUSTOMER

Awaiting action or input from the customer.

COMPLETED_BY_CUSTOMER

Customer has completed the required steps.

EXPIRED

The customer's opportunity or session expired.

queryParametersArray of objects or null(QueryParameter)required

Session input elements

queryParameters[].​countryCodenull or stringrequired

ISO 3166-1 alpha-3 code representing the country for which the customer is requesting information about the Data Subject.

queryParameters[].​dataPackagesArray of strings or null(DataPackage)

List of data packages requested for the specified country.

Enum ValueDescription
CREDIT_HISTORY

Historical credit data about the customer.

SCORE

Credit score calculated based on customer data.

BANK_ACCOUNT_CATEGORIZATION

Categorization of transactions in the customer's bank account.

IDENTIFICATION

Identification documents or data of the customer.

customerInputDeadlineExtendableUntilUtcnull or string(date-time)
dataPackageUpgradableUntilUtcnull or string(date-time)
Response
application/json
{
  "id": "7afe082c-70d7-405f-a479-25e8d33612d2",
  "createdAtUtc": "2025-03-12T00:00:00+00:00",
  "createdByName": "Wilford Lowery",
  "organizationalUnitName": null,
  "subjectEmail": "john.doe@example.com",
  "subjectFullName": "John Doe",
  "customerInputDeadlineUtc": "2025-03-26T00:00:00+00:00",
  "customerProgressStatus": "WAITING_FOR_CUSTOMER",
  "queryParameters": [
    { … }
  ],
  "customerInputDeadlineExtendableUntilUtc": null,
  "dataPackageUpgradableUntilUtc": null
}

Updates an existing session

Request

Appends query parameters to an existing session

Security
keycloakAuthLive or keycloakAuthTest
Path
sessionIdstring(uuid)required
Bodyapplication/json
queryParametersArray of objects or null(QueryParameter)

A collection of query parameters. At least one query parameter is required.

curl -i -X PATCH \
  'https://doc.mifundo.com/_mock/mca/v1/sessions/{sessionId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "queryParameters": null
  }'

Responses

OK

Bodyapplication/json
idstring(uuid)required

Unique Session identifier. Used in subsequent requests to fetch Session related data.

createdAtUtcstring(date-time)required

Session creation time in UTC.

createdByNamenull or string

Agent name who created the Session.

organizationalUnitNamenull or string

Organizational unit name of the agent who created the Session.

subjectEmailnull or stringrequired

Data Subject email. This is used to contact the Data Subject for getting Consents

subjectFullNamenull or string

Data Subject full name. Field will stay empty until subject has completed the identification step.

customerInputDeadlineUtcnull or string(date-time)

Deadline by which the customer is expected to provide input. If Data Subject hasn't provided the input by that time, new Session should be created.

customerProgressStatusstringrequired

Current Session status.

Enum ValueDescription
DELIVERY_FAILED

Delivery to the customer failed.

WAITING_FOR_CUSTOMER

Awaiting action or input from the customer.

COMPLETED_BY_CUSTOMER

Customer has completed the required steps.

EXPIRED

The customer's opportunity or session expired.

queryParametersArray of objects or null(QueryParameter)required

Session input elements

queryParameters[].​countryCodenull or stringrequired

ISO 3166-1 alpha-3 code representing the country for which the customer is requesting information about the Data Subject.

queryParameters[].​dataPackagesArray of strings or null(DataPackage)

List of data packages requested for the specified country.

Enum ValueDescription
CREDIT_HISTORY

Historical credit data about the customer.

SCORE

Credit score calculated based on customer data.

BANK_ACCOUNT_CATEGORIZATION

Categorization of transactions in the customer's bank account.

IDENTIFICATION

Identification documents or data of the customer.

customerInputDeadlineExtendableUntilUtcnull or string(date-time)
dataPackageUpgradableUntilUtcnull or string(date-time)
Response
application/json
{
  "id": "18a50fc6-69e0-4d6e-883d-de419cc207be",
  "createdAtUtc": "2025-03-12T00:00:00+00:00",
  "createdByName": "Wilford Lowery",
  "organizationalUnitName": null,
  "subjectEmail": "john.doe@example.com",
  "subjectFullName": "John Doe",
  "customerInputDeadlineUtc": "2025-03-26T00:00:00+00:00",
  "customerProgressStatus": "WAITING_FOR_CUSTOMER",
  "queryParameters": [
    { … }
  ],
  "customerInputDeadlineExtendableUntilUtc": null,
  "dataPackageUpgradableUntilUtc": null
}

Extends customer input deadline for the session

Request

Extends customer input deadline from the current date by the number of days defined in the authenticated user configuration

Security
keycloakAuthLive or keycloakAuthTest
Path
sessionIdstring(uuid)required
curl -i -X POST \
  'https://doc.mifundo.com/_mock/mca/v1/sessions/{sessionId}/actions/extend-customer-input-deadline' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Created

Bodyapplication/json
idstring(uuid)required

Unique Session identifier. Used in subsequent requests to fetch Session related data.

createdAtUtcstring(date-time)required

Session creation time in UTC.

createdByNamenull or string

Agent name who created the Session.

organizationalUnitNamenull or string

Organizational unit name of the agent who created the Session.

subjectEmailnull or stringrequired

Data Subject email. This is used to contact the Data Subject for getting Consents

subjectFullNamenull or string

Data Subject full name. Field will stay empty until subject has completed the identification step.

customerInputDeadlineUtcnull or string(date-time)

Deadline by which the customer is expected to provide input. If Data Subject hasn't provided the input by that time, new Session should be created.

customerProgressStatusstringrequired

Current Session status.

Enum ValueDescription
DELIVERY_FAILED

Delivery to the customer failed.

WAITING_FOR_CUSTOMER

Awaiting action or input from the customer.

COMPLETED_BY_CUSTOMER

Customer has completed the required steps.

EXPIRED

The customer's opportunity or session expired.

queryParametersArray of objects or null(QueryParameter)required

Session input elements

queryParameters[].​countryCodenull or stringrequired

ISO 3166-1 alpha-3 code representing the country for which the customer is requesting information about the Data Subject.

queryParameters[].​dataPackagesArray of strings or null(DataPackage)

List of data packages requested for the specified country.

Enum ValueDescription
CREDIT_HISTORY

Historical credit data about the customer.

SCORE

Credit score calculated based on customer data.

BANK_ACCOUNT_CATEGORIZATION

Categorization of transactions in the customer's bank account.

IDENTIFICATION

Identification documents or data of the customer.

customerInputDeadlineExtendableUntilUtcnull or string(date-time)
dataPackageUpgradableUntilUtcnull or string(date-time)
Response
application/json
{
  "id": "4d7bf7d3-c412-4127-91c8-85b2d85dcf13",
  "createdAtUtc": "2025-03-12T00:00:00+00:00",
  "createdByName": "Wilford Lowery",
  "organizationalUnitName": null,
  "subjectEmail": "john.doe@example.com",
  "subjectFullName": "John Doe",
  "customerInputDeadlineUtc": "2025-03-26T00:00:00+00:00",
  "customerProgressStatus": "WAITING_FOR_CUSTOMER",
  "queryParameters": [
    { … }
  ],
  "customerInputDeadlineExtendableUntilUtc": null,
  "dataPackageUpgradableUntilUtc": null
}

SourceFiles

Original responses from credit bureaus and other sources of information

Operations

Identity verification

Operations