API ReferenceTransactions

Create Bulk Transactions Upload URL

Generates up to 10 presigned PUT URLs for uploading JSONL transaction files (up to 5GB each) directly to storage. Each URL is valid for 15 minutes. Use the returned URL to upload the file via an HTTP PUT request with the binary file content as the body. If a URL expires before the upload completes, you must request a new one. Files can be uploaded as plain JSONL or as a gzip-compressed file. Only `coreTransaction` type is supported for bulk file uploads. <b>Required scopes:</b> `transaction:write`

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

organizationIdstringRequired
Your issuer organization ID, provided by Kard

Headers

X-Kard-Target-IssuerstringOptional

Target issuer ID for BaaS providers. When set, the auth token will be scoped to this specific issuer. Required for BaaS providers; omit for standard issuer integrations.

Request

This endpoint expects an object.
datalist of objectsRequired

List of file upload requests (1–10 items per request).

Response

This endpoint returns an object.
datalist of objects
List of created file upload sessions.

Errors

400
Invalid Request
401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error