Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kard transactions API

The transactions API from Kard — 7 operation(s) for transactions.

Kard transactions API is one of 16 APIs that Kard publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include transactions. The published artifact set on APIs.io includes an OpenAPI specification, authentication docs, and an AsyncAPI specification.

This API exposes 7 operations across 7 paths, and defines 69 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 2 base URLs: https://rewards-api.getkard.com, https://test-rewards-api.getkard.com.

7 operations 7 paths 69 schemas 2 GET5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://rewards-api.getkard.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Kard transactions API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (OAuthScheme).

Paths & Operations 7

Across 7 paths, the API surfaces 7 operations — 2 GET, 5 POST. Each is listed below with its method, path, parameters, and response codes.

transactions 7
POST
/v2/issuers/{organizationId}/transactions
Create Incoming Transactions
create 2 params body → 202207400401409500
POST
/v2/issuers/{organizationId}/transactions/uploads
Create Bulk Transactions Upload URL
create-bulk-transactions-upload-url 2 params body → 201400401403500
POST
/v2/issuers/{organizationId}/users/{userId}/audits
Create Audits
create-audits 3 params body → 201207400401404409500
GET
/v2/issuers/{organizationId}/users/{userId}/earned-rewards
Get Earned Rewards
get-earned-rewards 9 params → 200400401404500
POST
/transactions/incoming
Create Incoming Transaction
create-incoming-transaction 1 param body → 201400401500
POST
/transactions/audit
Create Audit
create-audit 1 param body → 201400401409500
GET
/transactions/audit/{id}
Get Audit Status
get-audit-by-id 2 params → 200400401404500

Schemas 69

The contract defines 69 schemas that model the data the API accepts and returns. The most detailed are type_transactions:IncomingTransactionRequest (32 properties), type_transactions:TransactionsAttributes (29 properties), type_transactions:MatchedTransactionsAttributes (21 properties), type_transactions:GetAuditByIdResponse (14 properties). Each schema is shown below with its type and property counts.

type_commons:RelationshipData
object
2 properties 2 required
type_commons:RequestValidationErrorResponse
object
1 property 1 required
type_transactions:DirectionType
string
type_transactions:CreateFileUploadAttributes
object
1 property 1 required
type_transactions:CoreTransactionAttributes
object
12 properties 9 required
type_transactions:RewardedTransactionStatus
string
type_transactions:CreateAuditResponseBody
object
1 property 1 required
type_transactions:AuditResponseAttributes
object
1 property 1 required
type_transactions:CreateIncomingTransactionRequestBody
array
type_transactions:TransactionsResponseData
object
3 properties 3 required
type_transactions:FileUploadType
string
Specifies the category of transaction file being uploaded. Use incomingTransactionsFile for new, real-time transactions that need to be processed and matched a…
type_transactions:IncomingTransactionRequest
object
32 properties 6 required
type_transactions:TransactionMerchantAttributes
object
2 properties 1 required
type_transactions:RewardedTransactionRelationships
object
3 properties 3 required
type_transactions:States
string
type_transactions:CommissionEarnedDetails
object
1 property 1 required
type_transactions:TransactionOfferAttributes
object
1 property 1 required
type_transactions:TransactionsMultiResponse
object
2 properties 2 required
type_transactions:Transactions
type_transactions:CreateAuditRequestBody_2
object
10 properties 6 required
type_commons:RelationshipSingle
object
1 property 1 required
type_transactions:TransactionPaymentType
string
type_transactions:FileUploadUrlData
object
3 properties 3 required
type_commons:ErrorObject
object
5 properties 3 required
type_transactions:CreateFileUploadUrlResponse
object
1 property 1 required
type_transactions:ProcessorMid
type_commons:CommissionValueType
string
The type of commission value
type_transactions:TransactionStatus
string
type_transactions:CreateFileUploadRequestBody
object
1 property 1 required
type_transactions:PaymentType
string
type_commons:InvalidRequestUnion
type_transactions:CreateAuditMultiStatusResponse
object
2 properties 1 required
type_commons:CardNetwork
string
Supported card networks
type_transactions:MerchantAssetType
string
type_commons:Job
object
2 properties 2 required
type_transactions:AuditStatus
string
type_transactions:RewardedTransactionUnion
type_commons:ErrorResponse
object
1 property 1 required
type_transactions:CreateAuditResponse
object
11 properties 7 required
type_transactions:RewardedTransactionAttributes
object
7 properties 6 required
type_transactions:ApprovedTransactionAttributes
object
4 properties 4 required
type_transactions:AuditAttributes
object
4 properties 4 required
type_transactions:GetEarnedRewardsMeta
object
1 property 1 required
type_transactions:FileUploadUrlAttributes
object
2 properties 2 required
type_commons:JobStatus
string
Status of the job
type_transactions:TransactionIncludedResource
type_commons:MongoId
string
The unique identifier for a document in the database
type_transactions:GetEarnedRewardsResponse
object
4 properties 3 required
type_transactions:PaymentStatus
string
type_transactions:TransactionsResponse
object
1 property 1 required
type_transactions:TransactionsAttributes
object
29 properties 10 required
type_transactions:VisaMidDetails
object
2 properties 2 required
type_transactions:MatchedTransactionsAttributes
object
21 properties 7 required
type_commons:State
string
type_transactions:CreateAuditRequestDataUnion
type_commons:Links
object
Related links to the API call
3 properties 1 required
type_transactions:ReceiptMediumType
string
type_commons:ErrorSource
object
3 properties
type_commons:CommissionValue
object
2 properties 2 required
type_transactions:GetAuditByIdResponse
object
14 properties 7 required
type_commons:OrganizationId
string
Your issuer organization ID, provided by Kard
type_transactions:CreateAuditResponseDataUnion
type_transactions:MerchantAsset
object
3 properties 2 required
type_transactions:CreateFileUploadData
object
2 properties 2 required
type_transactions:TransactionsRequestBody
object
1 property 1 required
type_commons:UnauthorizedErrorBody
object
1 property 1 required
type_transactions:CreateAuditRequestBody
object
1 property 1 required
type_transactions:Merchant
object
10 properties 1 required
type_commons:ResourceType
string
Type of document returned

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kard-transactions-api-openapi.yml Raw ↑

Other APIs Kard publishes across the network.

Kard attributions API
Kard Files API
Kard notifications > Notifications API
Kard notifications > Subscriptions API
Kard Organizations API
Kard Organizations > Children API
Kard Organizations > ContentStrategies API
Kard Organizations > Placements API
Kard Ping API
Kard rewards API
Kard users API
Kard users > attributions API