Skip to main content
GET
/
transaction
/
{transactionId}
cURL
curl --request GET \
  --url https://api.covenance.com/transaction/{transactionId} \
  --header 'x-api-key: <api-key>'
{
  "id": "<string>",
  "date": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "amountCents": 123,
  "status": "pending",
  "referenceNumber": "<string>",
  "authorizedAt": "2023-11-07T05:31:56Z",
  "merchantData": {
    "description": "<string>",
    "categoryCode": "<string>"
  },
  "cardId": "<string>",
  "originalCurrency": {
    "code": "<string>",
    "amountCents": 123,
    "conversionRate": 123
  },
  "declineReason": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
transactionId
string
required

Response

OK

​
id
string
required

Identification of the transaction

​
date
string<date-time>
required

Date in UTC time when the transaction was posted

​
description
string
required

Description of the transaction

​
amountCents
number
required

The amount of the transaction in cents in USD. If the transaction amount is negative, the transaction is a debit. If the transaction amount is positive, the transaction is a credit

​
status
enum<string>
required

Status of the transaction

Available options:
pending,
canceled,
failed,
settled,
declined,
refund,
reversed,
returned,
dispute
​
referenceNumber
string
required

The reference number provided by Visa for this transaction

​
authorizedAt
string<date-time>
required

UTC timestamp of when the transaction was authorized. Only exists for card transactions

​
merchantData
object

For card transactions, contains description of the transaction as reported by the merchant and merchant category code. For other transactions, this field is undefined

​
cardId
string

Identification of the card

​
originalCurrency
object

Original currency of the transaction

​
declineReason
string

Decline reason of the transaction