Skip to content

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 identifier of the session. Used in subsequent requests to retrieve session-related data.

createdAtUtcstring, (date-time)required

Timestamp (UTC) at which the session was created.

createdByNamenull or string

Name of the agent who created the session.

organizationalUnitNamenull or string

Organizational unit of the agent who created the session.

subjectEmailnull or stringrequired

Email address of the data subject, used to request the required consents.

subjectFullNamenull or string

Full name of the data subject. Empty until the data subject has completed the identification step.

customerInputDeadlineUtcnull or string, (date-time)

Deadline (UTC) by which the data subject must provide the required input. If the deadline passes without input, a new session must be created.

customerProgressStatusstring(CustomerProgressStatusType)required

Current progress status of the data subject's input.

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

Data packages requested for the session.

customerInputDeadlineExtendableUntilUtcnull or string, (date-time)

Latest point in time (UTC) up to which the customer input deadline may be extended.

dataPackageUpgradableUntilUtcnull or string, (date-time)

Latest point in time (UTC) up to which the data packages may be upgraded.

customerInputCompletedAtUtcnull or string, (date-time)

Timestamp (UTC) at which all currently applicable customer input requirements were fulfilled, taken from the most recently satisfied requirement. Null while any requirement remains outstanding; may revert to null if new requirements are introduced.

externalReferencenull or string

A free-text reference supplied by the consumer to correlate the session with their own system (e.g. subject name, contract number, internal ID).

Response
{ "id": "db366925-d8c3-4821-9275-57faaf30e2c0", "createdAtUtc": "2025-03-12T00:00:00+00:00", "createdByName": "Wilford Lowery", "organizationalUnitName": null, "subjectEmail": "john.doe@example.com", "subjectFullName": "John Doe", "customerInputDeadlineUtc": "2027-03-26T00:00:00+00:00", "customerProgressStatus": "WAITING_FOR_CUSTOMER", "queryParameters": [ { … } ], "customerInputDeadlineExtendableUntilUtc": null, "dataPackageUpgradableUntilUtc": null, "customerInputCompletedAtUtc": null, "externalReference": "CR-1234-567890/VIP" }