Get Operation Status

The endpoint can be used to retrieve current status of any operation (not just payment) performed on the API. The endpoint receives operationID of the request performed earlier and returns its status.

Operation can have one of the following statuses:

  • done
  • initialized
  • user_input_required
  • failed

To read more about operation statuses, you can visit Operation Statuses

👍

Pre-Conditions

You have obtained user's permanent access token from Exchange Token endpoint.

To read more about authentication process and access token please refer to Authentication Documentation

Request

https://api.dapi.com/v2/operation/get

Headers

Body Parameters

ParameterTypeDescription
appKey
REQUIRED
StringApp key generated at application creation.
appSecret
REQUIRED
StringPrivate token generated at application creation.
operationID
REQUIRED
StringUnique ID generated to identify a specific operation.

Request Example

{
	"appKey": "b61812ed5f27889fe3c14001137b35de438cd9baea0a5a3df58a92205dae84b7",
	"appSecret": "c29eea94b3ed3ddd48306f24077cc15f17d61be144ce532ecc29dd962d46223a",
	"operationID":"CBDUAEAD:f64e6f59-ead8-4074-9602-e978b50abb57"
}

Response

📘

Note

Your responses may differ from those listed below on a case-by-case basis.

ParameterTypeDescription
opInfoOpInfoAn object containing the operation info.
statusStringReturns the status of the job. It can be one of following:
- done

- initialized

- user_input_required

- failed
successBooleanReturns true if request is successful and false for all else.

OpInfo Schema

ParameterTypeDescription
endDateDateThe operation start date.
startDateDateThe operation end date.
errorTypeStringDescriptive error message only in case of failure
statusStringReturns the status of the job. It can be one of following:
- done

- initialized

- user_input_required

- failed
typeStringThe API endpoint path that was called.
transferDetailsTransferDetailsReturns null if not a transfer operation.

Response Example

{
    "opInfo": {
        "endDate": "2023-08-25T14:26:21.577Z",
        "errorType": "",
        "startDate": "2023-08-25T14:26:21.229Z",
        "status": "done",
        "transferDetails": null,
        "type": "data/identity/get"
    },
    "status": "done",
    "success": true
}

Successful Request / Response

Successful Request

{
	"appKey": "b61812ed5f27889fe3c14001137b35de438cd9baea0a5a3df58a92205dae84b7",
	"appSecret": "c29eea94b3ed3ddd48306f24077cc15f17d61be144ce532ecc29dd962d46223a",
	"operationID":"CBDUAEAD:f64e6f59-ead8-4074-9602-e978b50abb57"
}

Successful Response

{
    "opInfo": {
        "endDate": "2023-08-25T14:26:21.577Z",
        "errorType": "",
        "startDate": "2023-08-25T14:26:21.229Z",
        "status": "done",
        "transferDetails": null,
        "type": "data/identity/get"
    },
    "status": "done",
    "success": true
}

Failed Request / Response - OperationID Not Provided

Failed Request - OperationID Not Provided

{
	"appKey": "b61812ed5f27889fe3c14001137b35de438cd9baea0a5a3df58a92205dae84b7",
	"appSecret": "c29eea94b3ed3ddd48306f24077cc15f17d61be144ce532ecc29dd962d46223a"
}

Failed Response - OperationID Not Provided

{
    "msg": "validation error on field 'operationID'. err: value must not be an empty string",
    "type": "INVALID_ARGS",
    "success": false,
    "status": "failed"
}

Failed Request / Response - Invalid OperationID Provided

Failed Request - Invalid OperationID Provided

{
	"appKey": "b61812ed5f27889fe3c14001137b35de438cd9baea0a5a3df58a92205dae84b7",
	"appSecret": "c29eea94b3ed3ddd48306f24077cc15f17d61be144ce532ecc29dd962d46223a",
  "operationID": "XXXXX:f64e6f59-ead8-4074-9602-e978b50abb571"
}

Failed Response - Invalid OperationID Provided

{
    "msg": "Operation not found",
    "type": "NOT_FOUND",
    "success": false,
    "status": "failed"
}

Failed Request / Response - Invalid JSON Body Provided

Request - Invalid JSON Body Provided

{
	"appKey": "b61812ed5f27889fe3c14001137b35de438cd9baea0a5a3df58a92205dae84b7",
	"appSecret": "c29eea94b3ed3ddd48306f24077cc15f17d61be144ce532ecc29dd962d46223a"
	"operationID":"CBDUAEAD:f64e6f59-ead8-4074-9602-e978b50abb57"
}

Response - Invalid JSON Body Provided

{
    "msg": "Invalid JSON request",
    "type": "BAD_REQUEST",
    "success": false,
    "status": "failed"
}

📘

Note

For more information and detailed breakdown of possible errors, please see Errors.