Create Bulk Transactions Upload URL

curl -X POST https://rewards-api.getkard.com/v2/issuers/organization-123/transactions/upload \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "data": [
    {
      "type": "incomingTransactionsFile",
      "attributes": {
        "filename": "transaction_12345.jsonl"
      }
    },
    {
      "type": "incomingTransactionsFile",
      "attributes": {
        "filename": "transaction_67890.jsonl"
      }
    }
  ]
}'

{
  "data": [
    {
      "type": "incomingTransactionsFile",
      "id": "2NxKz7TYmqVH8UrjGP1xK3hF2gs",
      "attributes": {
        "url": "https://s3.amazonaws.com/bucket/key1?X-Amz-Algorithm=...",
        "expiresIn": 900
      }
    },
    {
      "type": "incomingTransactionsFile",
      "id": "3PqLa8UZnrWI9VskHQ2yL4iG3ht",
      "attributes": {
        "url": "https://s3.amazonaws.com/bucket/key2?X-Amz-Algorithm=...",
        "expiresIn": 900
      }
    }
  ]
}

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. Required scopes: transaction:write

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

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.

Authentication

Path parameters

Request

Response

Errors