Reprocess logs - Interstellas

Every call to Reprocess — whether for a whole batch or a single item — creates a log entry. These endpoints let you query that history, which is useful for auditing who retried what and why an attempt failed, independent of the item’s current live status.

Logs for a batch

Returns reprocess log entries for every item in a batch, most recent first.

Endpoint

GET /clients/business/customers/funds/bulk-transfer/{bulkTransferId}/reprocess-logs

Path parameters

bulkTransferId

string

required

The batch to fetch reprocess logs for.

Headers

x-api-key

string

required

Your public API key.

x-api-secret

string

required

Your API secret. Use a stl_test_... value in sandbox, stl_live_... in production.

businessId

string

required

Your business ID.

Query parameters

page

integer

Page number. Defaults to 1.

limit

integer

Records per page. Defaults to 20, capped at 100.

new_status

string

Filter to logs whose outcome was this status. One of completed, failed, pending.

triggered_by_type

string

Filter to logs triggered by this actor type. One of member, admin, system.

from_date

string

ISO 8601 date — only include logs created on or after this date.

to_date

string

ISO 8601 date — only include logs created on or before this date.

API-triggered reprocesses are recorded with triggeredByType: "api" in the response, but triggered_by_type as a filter only accepts member, admin, or system — passing api is rejected as an invalid query parameter. There’s currently no way to filter this endpoint down to only API-triggered attempts; omit the filter and check triggeredByType in the results client-side instead.

Response

status

boolean

true on success.

message

string

Human-readable outcome.

data.logs

array

Reprocess log entries, most recently created first.

data.logs[].id

string

Unique ID for this log entry.

data.logs[].bulkTransferId

string

The batch this log entry belongs to.

data.logs[].bulkTransferItemId

string

The item this log entry is about.

data.logs[].originalTransactionReference

string

The transaction reference the item had immediately before this reprocess attempt.

data.logs[].newTransactionReference

string

The new transaction reference generated for this attempt.

data.logs[].triggeredBy

string

ID of whoever (or whatever) triggered this reprocess — a member ID or your API client’s ID, depending on triggeredByType.

data.logs[].triggeredByType

string

Who triggered this attempt: member (dashboard user), api (an API-key request like this one), admin, or system.

data.logs[].triggeredByName

string

Display name of the trigger, if available. null for API-triggered attempts.

data.logs[].previousStatus

string

The item’s status immediately before this attempt — always failed, since only failed items are eligible for reprocessing.

data.logs[].newStatus

string

The item’s resulting status after this attempt. null while the attempt is still in flight.

data.logs[].failureReason

string

Why the attempt failed, if newStatus is failed. null otherwise.

data.logs[].createdAt

string

ISO 8601 timestamp of when this reprocess attempt was initiated.

pagination.page

integer

The current page number.

pagination.limit

integer

The page size used for this response.

pagination.total

integer

Total number of log entries matching the current query, across all pages.

pagination.totalPages

integer

The final page number, derived from total ÷ limit.

Code examples

curl -X GET "https://sandbox.stellasbank.com/api/v1/clients/business/customers/funds/bulk-transfer/6f9d3e2a-1b4c-4a8d-9e2f-3c1a2b4d5e6f/reprocess-logs?page=1&limit=20" \
  -H "x-api-key: stl_c8e286ca55b0123e0b05da047494f585" \
  -H "x-api-secret: stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0" \
  -H "businessId: YOUR_BUSINESS_ID"

const res = await fetch(
  "https://sandbox.stellasbank.com/api/v1/clients/business/customers/funds/bulk-transfer/6f9d3e2a-1b4c-4a8d-9e2f-3c1a2b4d5e6f/reprocess-logs?page=1&limit=20",
  {
    headers: {
      "x-api-key": "stl_c8e286ca55b0123e0b05da047494f585",
      "x-api-secret": "stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0",
      businessId: "YOUR_BUSINESS_ID",
    },
  }
);
const { data, pagination } = await res.json();

import requests

res = requests.get(
    "https://sandbox.stellasbank.com/api/v1/clients/business/customers/funds/bulk-transfer/6f9d3e2a-1b4c-4a8d-9e2f-3c1a2b4d5e6f/reprocess-logs",
    headers={
        "x-api-key": "stl_c8e286ca55b0123e0b05da047494f585",
        "x-api-secret": "stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0",
        "businessId": "YOUR_BUSINESS_ID",
    },
    params={"page": 1, "limit": 20},
)
print(res.json())

Example response

{
  "status": true,
  "message": "Reprocess logs retrieved successfully",
  "data": {
    "logs": [
      {
        "id": "log-0001",
        "bulkTransferId": "6f9d3e2a-1b4c-4a8d-9e2f-3c1a2b4d5e6f",
        "bulkTransferItemId": "a1b2c3d4-0000-4a8d-9e2f-000000000002",
        "originalTransactionReference": "TRX-def456",
        "newTransactionReference": "TRX-ghi789",
        "triggeredBy": "6f9d3e2a-client-0001",
        "triggeredByType": "api",
        "triggeredByName": null,
        "previousStatus": "failed",
        "newStatus": "completed",
        "failureReason": null,
        "createdAt": "2024-07-01T10:15:00.000Z"
      }
    ]
  },
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  }
}

Errors

Status	Cause
`400 Bad Request`	`bulkTransferId` isn’t a valid UUID, or a filter value fails validation (e.g. an out-of-range `limit`, or an invalid `new_status`/`triggered_by_type`)
`401 Unauthorized`	`businessId` header missing, or credentials invalid
`404 Not Found`	No bulk transfer with this ID exists for your client and business

Logs for a single item

Same as above, scoped to one item within a batch.

Endpoint

GET /clients/business/customers/funds/bulk-transfer/{bulkTransferId}/items/{itemId}/reprocess-logs

Path parameters

bulkTransferId

string

required

The batch the item belongs to.

itemId

string

required

The item to fetch reprocess logs for.

Headers

x-api-key

string

required

Your public API key.

x-api-secret

string

required

Your API secret. Use a stl_test_... value in sandbox, stl_live_... in production.

businessId

string

required

Your business ID.

Query parameters

page

integer

Page number. Defaults to 1.

limit

integer

Records per page. Defaults to 20, capped at 100.

new_status

string

Filter to logs whose outcome was this status. One of completed, failed, pending.

from_date

string

ISO 8601 date — only include logs created on or after this date.

to_date

string

ISO 8601 date — only include logs created on or before this date.

Unlike the batch-level endpoint above, this one does not support filtering by triggered_by_type.

Response

Same response shape as logs for a batch above, filtered to the one item.

Code examples

curl -X GET "https://sandbox.stellasbank.com/api/v1/clients/business/customers/funds/bulk-transfer/6f9d3e2a-1b4c-4a8d-9e2f-3c1a2b4d5e6f/items/a1b2c3d4-0000-4a8d-9e2f-000000000002/reprocess-logs" \
  -H "x-api-key: stl_c8e286ca55b0123e0b05da047494f585" \
  -H "x-api-secret: stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0" \
  -H "businessId: YOUR_BUSINESS_ID"

const res = await fetch(
  "https://sandbox.stellasbank.com/api/v1/clients/business/customers/funds/bulk-transfer/6f9d3e2a-1b4c-4a8d-9e2f-3c1a2b4d5e6f/items/a1b2c3d4-0000-4a8d-9e2f-000000000002/reprocess-logs",
  {
    headers: {
      "x-api-key": "stl_c8e286ca55b0123e0b05da047494f585",
      "x-api-secret": "stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0",
      businessId: "YOUR_BUSINESS_ID",
    },
  }
);
const { data, pagination } = await res.json();

import requests

res = requests.get(
    "https://sandbox.stellasbank.com/api/v1/clients/business/customers/funds/bulk-transfer/6f9d3e2a-1b4c-4a8d-9e2f-3c1a2b4d5e6f/items/a1b2c3d4-0000-4a8d-9e2f-000000000002/reprocess-logs",
    headers={
        "x-api-key": "stl_c8e286ca55b0123e0b05da047494f585",
        "x-api-secret": "stl_test_6332e4b1dd6c2e5814395b549aec6deb0d0664406c66f2285f95f801c76117c0",
        "businessId": "YOUR_BUSINESS_ID",
    },
)
print(res.json())

Errors

Status	Cause
`400 Bad Request`	`bulkTransferId` or `itemId` isn’t a valid UUID, or a filter value fails validation
`401 Unauthorized`	`businessId` header missing, or credentials invalid
`404 Not Found`	No bulk transfer with this ID exists for your client and business, or no item with this ID exists in that batch

See Errors for the full envelope and error code reference.

​Logs for a batch

​Endpoint

​Path parameters

​Headers

​Query parameters

​Response

​Code examples

​Example response

​Errors

​Logs for a single item

​Endpoint

​Path parameters

​Headers

​Query parameters

​Response

​Code examples

​Errors

Logs for a batch

Endpoint

Path parameters

Headers

Query parameters

Response

Code examples

Example response

Errors

Logs for a single item

Endpoint

Path parameters

Headers

Query parameters

Response

Code examples

Errors