Bulk action object

Create or update up to 5,000 items with a single API request using bulk actions

Bulk actions enable you to create or modify up to 5,000 items with a single API request. They are particularly useful if you want to create or modify a large number of items while keeping the number of API requests minimal. Learn more in our dedicated guide.

⚠️

Bulk actions are excluded from throughput and latency service levels.

Attribute

Description

id string

The bulk action ID.

object
string

Always bulk_action.

target_object
string

The object related to the bulk action. payment_order and internal_account are currently supported.

action
string

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

  • For payment_order, create, approve, and cancel are supported
  • For internal_account, create is supported

status
string

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

total_items
integer

The number of items included in the bulk action.

total_successful
integer

The number of items successfully processed.

total_failed
integer

The number of items that failed to be processed.

processed_at
datetime

The UTC timestamp when the bulk action was processed.

created_at
datetime

The UTC timestamp of the creation of the bulk action.

Below is an example of a bulk action object:

{
  "id": "daa012d7-542e-412c-859e-9777079ffda4",
  "object": "bulk_action",
  "target_object": "payment_order",
  "action": "create",
  "status": "executed",
  "total_items": 200,
  "total_successful": 198,
  "total_failed": 2,
  "processed_at": "2024-03-17T16:17:02.445697Z",
  "created_at": "2024-03-17T16:16:40.445697Z"
}