Create Bulk Transactions Upload URL

curl -X POST https://rewards-api.getkard.com/v2/issuers/organization-123/transactions/uploads \
     -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. Supports both incomingTransactionsFile for daily transaction ingestion and historicalTransactionsFile for historical transaction ingestion. See the Historical Transaction Uploads integration guide for details on the historical flow. 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. Supports both `incomingTransactionsFile` for daily transaction ingestion and `historicalTransactionsFile` for historical transaction ingestion. See the [Historical Transaction Uploads](/2024-10-01/api/integration-guides/historical-transaction-uploads) integration guide for details on the historical flow. <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.

Errors

400

Invalid Request

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error