SalesChannelBatchRequests

Get batch request details

get

Returns details of a specific batch request

Authorizations

Path parameters

channel_idintegerRequired

The channel ID of the resource.

Example: 5

idintegerRequired

Unique identifier of the resource

Example: 1

Responses

200

Batch request details

application/json

404

Batch request not found

application/json

get

GET /api/v1/channel/{channel_id}/batch_requests/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "pk": 1,
  "channel": 1,
  "local_batch_id": "123e4567-e89b-12d3-a456-426614174000",
  "remote_batch_id": "text",
  "content_type": "text",
  "status": "initialized",
  "objects": [
    {
      "pk": 1,
      "failed_reason_type": "text",
      "remote_id": "text",
      "version_date": "2025-08-30T01:54:15.791Z",
      "content_type": "text"
    }
  ],
  "created_date": "2025-08-30T01:54:15.791Z",
  "modified_date": "2025-08-30T01:54:15.791Z"
}

Update batch request

put

Updates a batch request with the provided data

Authorizations

Path parameters

channel_idintegerRequired

The channel ID of the resource.

Example: 5

idintegerRequired

Unique identifier of the resource

Example: 1

Body

channelinteger · int64Optional

ID of the channel

remote_batch_idstring | nullableOptional

Remote batch ID

content_typestring | nullableOptional

Content type of the batch request

statusstring · enumOptional

Status of the batch request

Possible values:

log_filestring | nullableOptional

Log file content

Responses

200

Batch request updated successfully

application/json

400

Invalid request data

application/json

404

Batch request not found

application/json

500

Batch request cannot be updated

application/json

put

PUT /api/v1/channel/{channel_id}/batch_requests/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 233

{
  "channel": 1,
  "remote_batch_id": "text",
  "content_type": "text",
  "status": "initialized",
  "objects": [
    {
      "pk": 1,
      "failed_reason_type": "text",
      "remote_id": "text",
      "version_date": "2025-08-30T01:54:15.791Z",
      "content_type": "text"
    }
  ],
  "log_file": "text"
}

{
  "pk": 1,
  "channel": 1,
  "local_batch_id": "123e4567-e89b-12d3-a456-426614174000",
  "remote_batch_id": "text",
  "content_type": "text",
  "status": "initialized",
  "objects": [
    {
      "pk": 1,
      "failed_reason_type": "text",
      "remote_id": "text",
      "version_date": "2025-08-30T01:54:15.791Z",
      "content_type": "text"
    }
  ],
  "created_date": "2025-08-30T01:54:15.791Z",
  "modified_date": "2025-08-30T01:54:15.791Z"
}

Delete batch request

delete

Deletes a batch request

Authorizations

Path parameters

channel_idintegerRequired

The channel ID of the resource.

Example: 5

idintegerRequired

Unique identifier of the resource

Example: 1

Responses

204

Batch request deleted successfully

No content

404

Batch request not found

application/json

delete

DELETE /api/v1/channel/{channel_id}/batch_requests/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*

No content

Partial update batch request

patch

Partially updates a batch request with the provided data

Authorizations

Path parameters

channel_idintegerRequired

The channel ID of the resource.

Example: 5

idintegerRequired

Unique identifier of the resource

Example: 1

Body

channelinteger · int64Optional

ID of the channel

remote_batch_idstring | nullableOptional

Remote batch ID

content_typestring | nullableOptional

Content type of the batch request

statusstring · enumOptional

Status of the batch request

Possible values:

log_filestring | nullableOptional

Log file content

Responses

200

Batch request updated successfully

application/json

400

Invalid request data

application/json

404

Batch request not found

application/json

500

Batch request cannot be updated

application/json

patch

PATCH /api/v1/channel/{channel_id}/batch_requests/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 233

{
  "channel": 1,
  "remote_batch_id": "text",
  "content_type": "text",
  "status": "initialized",
  "objects": [
    {
      "pk": 1,
      "failed_reason_type": "text",
      "remote_id": "text",
      "version_date": "2025-08-30T01:54:15.791Z",
      "content_type": "text"
    }
  ],
  "log_file": "text"
}

{
  "pk": 1,
  "channel": 1,
  "local_batch_id": "123e4567-e89b-12d3-a456-426614174000",
  "remote_batch_id": "text",
  "content_type": "text",
  "status": "initialized",
  "objects": [
    {
      "pk": 1,
      "failed_reason_type": "text",
      "remote_id": "text",
      "version_date": "2025-08-30T01:54:15.791Z",
      "content_type": "text"
    }
  ],
  "created_date": "2025-08-30T01:54:15.791Z",
  "modified_date": "2025-08-30T01:54:15.791Z"
}

List batch requests

get

Returns a list of batch requests for the specified channel

Authorizations

Path parameters

channel_idintegerRequired

The channel ID of the resource.

Example: 5

Query parameters

statusstring · enumOptional

Filter by status

Possible values:

content_typestringOptional

Filter by content type

orderingstringOptional

Order by field name

Responses

200

List of batch requests

application/json

404

Channel not found

application/json

get

GET /api/v1/channel/{channel_id}/batch_requests/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "count": 1,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "pk": 1,
      "channel": 1,
      "local_batch_id": "123e4567-e89b-12d3-a456-426614174000",
      "remote_batch_id": "text",
      "content_type": "text",
      "status": "initialized",
      "objects": [
        {
          "pk": 1,
          "failed_reason_type": "text",
          "remote_id": "text",
          "version_date": "2025-08-30T01:54:15.791Z",
          "content_type": "text"
        }
      ],
      "created_date": "2025-08-30T01:54:15.791Z",
      "modified_date": "2025-08-30T01:54:15.791Z"
    }
  ]
}

Create batch request

post

Creates a new batch request for the specified channel

Authorizations

Path parameters

channel_idintegerRequired

The channel ID of the resource.

Example: 5

Body

channelinteger · int64Required

ID of the channel

Responses

201

Batch request created successfully

application/json

400

Invalid request data

application/json

404

Channel not found

application/json

post

POST /api/v1/channel/{channel_id}/batch_requests/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 13

{
  "channel": 1
}

{
  "pk": 1,
  "channel": 1,
  "local_batch_id": "123e4567-e89b-12d3-a456-426614174000",
  "remote_batch_id": "text",
  "content_type": "text",
  "status": "initialized",
  "objects": [
    {
      "pk": 1,
      "failed_reason_type": "text",
      "remote_id": "text",
      "version_date": "2025-08-30T01:54:15.791Z",
      "content_type": "text"
    }
  ],
  "created_date": "2025-08-30T01:54:15.791Z",
  "modified_date": "2025-08-30T01:54:15.791Z"
}

PreviousSalesChannelOrderShippingInfo NextSalesChannelAddresses

Was this helpful?