NUnumeral
payee-verification-requests

Retrieve bulk action items

Retrieve the detailed results of all items in a bulk action, including which items succeeded and which failed with error details.

get/bulk_actions/payee_verification_requests/{id}/items

Request

Path parameters

idstring uuid required
Example:7eccce97-40ad-41ac-99e3-06155bdf9d63

The ID of the bulk action.

Response

Successfully retrieved bulk action items

idstring required

The bulk action ID.

objectstring required

Type of the object, bulk_action.

target_object'payment_order' | 'internal_account' required

The object related to the bulk action.

action'create' | 'approve' | 'cancel' required

The action to execute on the items included in the bulk action.

If target_action is payment_order, can be create, approve or cancel. If target_action is internal_account, can be create.

status'created' | 'processing' | 'executed' required

The status of the bulk action. Either created, processing, or executed.

total_itemsinteger required

The number of items included in the bulk action.

total_successfulinteger required

The number of items successfully processed.

total_failedinteger required

The number of items that failed to be processed.

processed_atstring date-time nullable required

The UTC timestamp when the bulk action was processed.

created_atstring date-time required

The UTC timestamp of the creation of the bulk action.

Example response

{
  "object": "bulk_action",
  "status": "processing",
  "total_items": 50,
  "total_successful": 24,
  "total_failed": 2,
  "created_at": "2024-01-03T11:53:19.734182Z",
  "succeeded": [
    {
      "id": "c39d1eff-c5ed-4197-8f24-28a68bd0eee6",
      "idempotency_key": "test-bulk-1",
      "error": "validation_error",
      "message": "validation errors occurred while processing request"
    }
  ],
  "failed": [
    {
      "id": "c39d1eff-c5ed-4197-8f24-28a68bd0eee6",
      "idempotency_key": "test-bulk-1",
      "error": "validation_error",
      "message": "validation errors occurred while processing request"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.