---
title: Get a Transaction
slug: mihai-tests/get-a-transaction
createdAt: 2025-05-02T10:16:35.486Z
---
{
"id": "gflQNgOh5C2ZXrGOHDDVk",
"type": "api-oas-v2",
"data": {
"method": "GET",
"url": "https://api.sandbox.tripleup.dev/partner/transactions/{id}",
"servers": [
{
"url": "https://api.sandbox.tripleup.dev/partner/transactions/{id}",
"description": "triple Sandbox"
}
],
"name": "Get a Transaction",
"description": "",
"contentType": "application/json",
"request": {
"pathParameters": [
{
"kind": "required",
"name": "id",
"type": "object",
"example": "triple-abc-123",
"description": "The triple-defined ID for the entity.",
"customType": "EntityId",
"schema": [],
"modelRef": "#/components/schemas/EntityId"
}
],
"headerParameters": [],
"queryParameters": [],
"bodyDataParameters": [],
"formDataParameters": [],
"oAuthParameters": []
},
"responses": [
{
"statusCode": "200",
"description": "Transaction",
"jsonExample": "",
"isExpanded": true,
"schema": [
{
"kind": "optional",
"type": "object",
"description": "",
"customType": "Transaction",
"schema": [
{
"name": "amount",
"kind": "required",
"type": "object",
"description": "The amount of the transaction. An error will be returned if the\nfield contains fractional amounts smaller than those allowed by the\ntransaction's currency code.\n",
"example": 12,
"modelRef": "#/components/schemas/TransactionAmount",
"customType": "TransactionAmount",
"schema": []
},
{
"name": "card_account_id",
"kind": "required",
"type": "string",
"description": "The triple-defined ID for the entity.",
"example": "triple-abc-123",
"modelRef": "#/components/schemas/EntityId",
"customType": "EntityId",
"schema": []
},
{
"name": "created_at",
"kind": "required",
"type": "string",
"description": "RFC 3339 date time used for creation and mod times",
"example": "2021-12-01T01:59:59.000Z",
"modelRef": "#/components/schemas/Timestamp",
"customType": "Timestamp",
"schema": []
},
{
"name": "currency_code",
"kind": "required",
"type": "string",
"description": "3-character ISO-4217 currency code. Only USD is currently supported.\n\nContact your Triple representative for support with additional\ncurrencies. Note that some values are not supported, particularly\ntest and fund codes.\n",
"example": "USD",
"default": "USD",
"modelRef": "#/components/schemas/CurrencyCode",
"customType": "CurrencyCode",
"schema": []
},
{
"name": "debit",
"kind": "required",
"type": "boolean",
"description": "Whether this is a debit or credit",
"modelRef": "#/components/schemas/TransactionIsDebit",
"customType": "TransactionIsDebit",
"schema": []
},
{
"name": "description",
"kind": "required",
"type": "string",
"description": "The transaction description, usually the merchant name",
"example": "Pittsburgh Zoo",
"modelRef": "#/components/schemas/TransactionDescription",
"customType": "TransactionDescription",
"schema": []
},
{
"name": "external_id",
"kind": "required",
"type": "string",
"description": "Partner-provided, external ID.\n\nExternal IDs should be stable and never sensitive.\n\nExternal IDs do not need to be globally unique, but we encourage the use of UUIDs.\nThey must be unique for Transactions within the scope of the associated Card Account.\n",
"modelRef": "#/components/schemas/TransactionExternalId",
"customType": "TransactionExternalId",
"schema": []
},
{
"name": "id",
"kind": "required",
"type": "string",
"description": "The triple-defined ID for the entity.",
"example": "triple-abc-123",
"modelRef": "#/components/schemas/EntityId",
"customType": "EntityId",
"schema": []
},
{
"name": "matching_status",
"kind": "required",
"type": "string",
"description": "The status of triple matching the Transaction to Offers.\n\n- `HISTORIC_TRANSACTION` - The Transaction was more than 3 days old\n when it was submitted to triple. It is not eligible for a Reward.\n- `NOT_APPLICABLE` - The Transaction is not a Purchase or Return,\n or is otherwise not eligible for a Reward.\n- `NOT_ENROLLED` - The Card Account was not enrolled for Rewards at\n the time of the Transaction.\n- `QUEUED` - The Transaction is waiting for Offer matching.\n- `NO_ACTIVE_OFFER` - The Transaction did not match any active Offer\n or meet Offer terms.\n- `MATCHED` - The Transaction was matched to offers and is\n potentially eligible for a reward. See `reward_details` for more\n information.\n",
"modelRef": "#/components/schemas/TransactionMatchingStatus",
"customType": "TransactionMatchingStatus",
"schema": []
},
{
"name": "merchant_address",
"kind": "required",
"type": "object",
"description": "A physical address in the world.\ntriple uses address validation services to update and standardize addresses on our platform. Address data sent to the API may be updated as we process, validate, and normalize addresses.\nNOTE: Though not marked as required, the street address, postal code, and country code are required for transaction matching to function properly.\n",
"modelRef": "#/components/schemas/Address",
"customType": "Address",
"schema": [
{
"name": "city",
"kind": "optional",
"type": "string",
"description": "Municipality or city name",
"example": "PITTSBURGH"
},
{
"name": "complete",
"kind": "optional",
"type": "string",
"description": "The complete delivery address, composed from the Address properties.\n",
"example": "7370 BAKER ST, STE 100\nPITTSBURGH, PA 15206",
"modelRef": "#/components/schemas/CompleteAddress",
"customType": "CompleteAddress",
"schema": []
},
{
"name": "country_code",
"kind": "optional",
"type": "string",
"description": "2-letter ISO-3166 country code",
"example": "US",
"modelRef": "#/components/schemas/CountryCode",
"customType": "CountryCode",
"schema": []
},
{
"name": "country_subdivision_code",
"kind": "optional",
"type": "string",
"description": "ISO-3166-2; 2-6 letter code for a country subdivision",
"example": "PA"
},
{
"name": "latitude",
"kind": "optional",
"type": "number",
"description": "",
"example": 40.440624,
"modelRef": "#/components/schemas/Latitude",
"customType": "Latitude",
"schema": []
},
{
"name": "longitude",
"kind": "optional",
"type": "number",
"description": "",
"example": -79.995888,
"modelRef": "#/components/schemas/Longitude",
"customType": "Longitude",
"schema": []
},
{
"name": "postal_code",
"kind": "optional",
"type": "string",
"description": "ZIP Code™, ZIP+4, or postal code",
"example": "15206",
"modelRef": "#/components/schemas/PostalCode",
"customType": "PostalCode",
"schema": []
},
{
"name": "street_address",
"kind": "optional",
"type": "string",
"description": "Single or multi-line physical address\n",
"example": "7370 BAKER ST, STE 100\n"
}
]
},
{
"name": "merchant_category",
"kind": "optional",
"type": "object",
"description": "",
"modelRef": "#/components/schemas/MerchantCategory",
"customType": "MerchantCategory",
"schema": [
{
"name": "code",
"kind": "required",
"type": "string",
"description": "The 4-digit Merchant Category Code",
"example": "7998",
"modelRef": "#/components/schemas/MerchantCategoryCode",
"customType": "MerchantCategoryCode",
"schema": []
},
{
"name": "description",
"kind": "required",
"type": "string",
"readOnly": true,
"description": "The description of the Merchant Category Code",
"example": "Aquariums, Dolphinariums, Seaquariums, and Zoos"
}
]
},
{
"name": "processor_mid",
"kind": "optional",
"type": "string",
"description": "The Merchant ID (MID) value",
"example": "9000012345",
"modelRef": "#/components/schemas/ProcessorMIDValue",
"customType": "ProcessorMIDValue",
"schema": []
},
{
"name": "processor_mid_type",
"kind": "optional",
"type": "string",
"description": "The type of Merchant ID",
"example": "VISA_VMID",
"modelRef": "#/components/schemas/ProcessorMIDType",
"customType": "ProcessorMIDType",
"schema": []
},
{
"name": "reward_details",
"kind": "optional",
"type": "array",
"description": "",
"modelRef": "#/components/schemas/RewardDetails",
"customType": "RewardDetails",
"schema": []
},
{
"name": "timestamp",
"kind": "required",
"type": "string",
"description": "RFC 3339 date time used for creation and mod times",
"example": "2021-12-01T01:59:59.000Z",
"modelRef": "#/components/schemas/Timestamp",
"customType": "Timestamp",
"schema": []
},
{
"name": "transaction_type",
"kind": "required",
"type": "string",
"description": "The type of transaction. triple will only calculate offers based on a\nhistory of Purchases and Refunds.\n",
"example": "PURCHASE",
"modelRef": "#/components/schemas/TransactionType",
"customType": "TransactionType",
"schema": []
},
{
"name": "updated_at",
"kind": "required",
"type": "string",
"description": "RFC 3339 date time used for creation and mod times",
"example": "2021-12-01T01:59:59.000Z",
"modelRef": "#/components/schemas/Timestamp",
"customType": "Timestamp",
"schema": []
}
],
"modelRef": "#/components/schemas/Transaction",
"isExpanded": true
}
]
},
{
"statusCode": "400",
"description": "TripleBadRequestError",
"jsonExample": "",
"isExpanded": true,
"schema": [
{
"kind": "optional",
"type": "object",
"description": "",
"schema": [
{
"name": "status_code",
"kind": "required",
"type": "integer",
"description": "The 3-digit HTTP Response Status code",
"example": 0
},
{
"name": "content",
"kind": "required",
"type": "object",
"description": "The error response content.",
"example": "",
"schema": [
{
"name": "details",
"kind": "optional",
"type": "array",
"description": "An array of error detail",
"modelRef": "#/components/schemas/ErrorResponseDetails",
"customType": "ErrorResponseDetails",
"schema": []
},
{
"name": "error_message",
"kind": "required",
"type": "string",
"description": "Short description of what went wrong.",
"example": "",
"default": "The request is malformed."
},
{
"name": "exception",
"kind": "required",
"type": "string",
"description": "The exception type.",
"example": ""
}
]
}
],
"isExpanded": true
}
]
},
{
"statusCode": "403",
"description": "TripleNotAuthenticatedError",
"jsonExample": "",
"isExpanded": true,
"schema": [
{
"kind": "optional",
"type": "object",
"description": "",
"schema": [
{
"name": "status_code",
"kind": "required",
"type": "integer",
"description": "The 3-digit HTTP Response Status code",
"example": 0
},
{
"name": "content",
"kind": "required",
"type": "object",
"description": "The error response content.",
"example": "",
"schema": [
{
"name": "details",
"kind": "optional",
"type": "array",
"description": "An array of error detail",
"modelRef": "#/components/schemas/ErrorResponseDetails",
"customType": "ErrorResponseDetails",
"schema": []
},
{
"name": "error_message",
"kind": "required",
"type": "string",
"description": "Short description of what went wrong.",
"example": "",
"default": "Client authentication failed."
},
{
"name": "exception",
"kind": "required",
"type": "string",
"description": "The exception type.",
"example": ""
}
]
}
],
"isExpanded": true
}
]
},
{
"statusCode": "404",
"description": "TripleInvalidPathError",
"jsonExample": "",
"isExpanded": true,
"schema": [
{
"kind": "optional",
"type": "object",
"description": "",
"schema": [
{
"name": "status_code",
"kind": "required",
"type": "integer",
"description": "The 3-digit HTTP Response Status code",
"example": 0
},
{
"name": "content",
"kind": "required",
"type": "object",
"description": "The error response content.",
"example": "",
"schema": [
{
"name": "details",
"kind": "optional",
"type": "array",
"description": "An array of error detail",
"modelRef": "#/components/schemas/ErrorResponseDetails",
"customType": "ErrorResponseDetails",
"schema": []
},
{
"name": "error_message",
"kind": "required",
"type": "string",
"description": "Short description of what went wrong.",
"example": "",
"default": "The url path or path parameter is invalid."
},
{
"name": "exception",
"kind": "required",
"type": "string",
"description": "The exception type.",
"example": ""
}
]
}
],
"isExpanded": true
}
]
},
{
"statusCode": "409",
"description": "TripleIntegrityError",
"jsonExample": "",
"isExpanded": true,
"schema": [
{
"kind": "optional",
"type": "object",
"description": "",
"schema": [
{
"name": "status_code",
"kind": "required",
"type": "integer",
"description": "The 3-digit HTTP Response Status code",
"example": 0
},
{
"name": "content",
"kind": "required",
"type": "object",
"description": "The error response content.",
"example": "",
"schema": [
{
"name": "details",
"kind": "optional",
"type": "array",
"description": "An array of error detail",
"modelRef": "#/components/schemas/ErrorResponseDetails",
"customType": "ErrorResponseDetails",
"schema": []
},
{
"name": "error_message",
"kind": "required",
"type": "string",
"description": "Short description of what went wrong.",
"example": "",
"default": "The request was well-formed but violated entity integrity constraints."
},
{
"name": "exception",
"kind": "required",
"type": "string",
"description": "The exception type.",
"example": ""
}
]
}
],
"isExpanded": true
}
]
},
{
"statusCode": "415",
"description": "TripleUnsupportedMediaType",
"jsonExample": "",
"isExpanded": true,
"schema": [
{
"kind": "optional",
"type": "object",
"description": "",
"schema": [
{
"name": "status_code",
"kind": "required",
"type": "integer",
"description": "The 3-digit HTTP Response Status code",
"example": 0
},
{
"name": "content",
"kind": "required",
"type": "object",
"description": "The error response content.",
"example": "",
"schema": [
{
"name": "details",
"kind": "optional",
"type": "array",
"description": "An array of error detail",
"modelRef": "#/components/schemas/ErrorResponseDetails",
"customType": "ErrorResponseDetails",
"schema": []
},
{
"name": "error_message",
"kind": "required",
"type": "string",
"description": "Short description of what went wrong.",
"example": "",
"default": "The request defined an unsupported media type."
},
{
"name": "exception",
"kind": "required",
"type": "string",
"description": "The exception type.",
"example": ""
}
]
}
],
"isExpanded": true
}
]
},
{
"statusCode": "422",
"description": "TripleUnprocessableEntity",
"jsonExample": "",
"isExpanded": true,
"schema": [
{
"kind": "optional",
"type": "object",
"description": "",
"schema": [
{
"name": "status_code",
"kind": "required",
"type": "integer",
"description": "The 3-digit HTTP Response Status code",
"example": 0
},
{
"name": "content",
"kind": "required",
"type": "object",
"description": "The error response content.",
"example": "",
"schema": [
{
"name": "details",
"kind": "optional",
"type": "array",
"description": "An array of error detail",
"modelRef": "#/components/schemas/ErrorResponseDetails",
"customType": "ErrorResponseDetails",
"schema": []
},
{
"name": "error_message",
"kind": "required",
"type": "string",
"description": "Short description of what went wrong.",
"example": "",
"default": "The request was well-formed but could not be processed."
},
{
"name": "exception",
"kind": "required",
"type": "string",
"description": "The exception type.",
"example": ""
}
]
}
],
"isExpanded": true
}
]
},
{
"statusCode": "500",
"description": "TripleInternalServerError",
"jsonExample": "",
"isExpanded": true,
"schema": [
{
"kind": "optional",
"type": "object",
"description": "",
"schema": [
{
"name": "status_code",
"kind": "required",
"type": "integer",
"description": "The 3-digit HTTP Response Status code",
"example": 0
},
{
"name": "content",
"kind": "required",
"type": "object",
"description": "The error response content.",
"example": "",
"schema": [
{
"name": "details",
"kind": "optional",
"type": "array",
"description": "An array of error detail",
"modelRef": "#/components/schemas/ErrorResponseDetails",
"customType": "ErrorResponseDetails",
"schema": []
},
{
"name": "error_message",
"kind": "required",
"type": "string",
"description": "Short description of what went wrong.",
"example": "",
"default": "Triple was unable to process the request due to an internal error."
},
{
"name": "exception",
"kind": "required",
"type": "string",
"description": "The exception type.",
"example": ""
}
]
}
],
"isExpanded": true
}
]
},
{
"statusCode": "501",
"description": "TripleNotImplementedError",
"jsonExample": "",
"isExpanded": true,
"schema": [
{
"kind": "optional",
"type": "object",
"description": "",
"schema": [
{
"name": "status_code",
"kind": "required",
"type": "integer",
"description": "The 3-digit HTTP Response Status code",
"example": 0
},
{
"name": "content",
"kind": "required",
"type": "object",
"description": "The error response content.",
"example": "",
"schema": [
{
"name": "details",
"kind": "optional",
"type": "array",
"description": "An array of error detail",
"modelRef": "#/components/schemas/ErrorResponseDetails",
"customType": "ErrorResponseDetails",
"schema": []
},
{
"name": "error_message",
"kind": "required",
"type": "string",
"description": "Short description of what went wrong.",
"example": "",
"default": "The request failed because it requires a feature that is not yet implemented."
},
{
"name": "exception",
"kind": "required",
"type": "string",
"description": "The exception type.",
"example": ""
}
]
}
],
"isExpanded": true
}
]
},
{
"statusCode": "503",
"description": "TripleServiceUnavailable",
"jsonExample": "",
"isExpanded": true,
"schema": [
{
"kind": "optional",
"type": "object",
"description": "",
"schema": [
{
"name": "status_code",
"kind": "required",
"type": "integer",
"description": "The 3-digit HTTP Response Status code",
"example": 0
},
{
"name": "content",
"kind": "required",
"type": "object",
"description": "The error response content.",
"example": "",
"schema": [
{
"name": "details",
"kind": "optional",
"type": "array",
"description": "An array of error detail",
"modelRef": "#/components/schemas/ErrorResponseDetails",
"customType": "ErrorResponseDetails",
"schema": []
},
{
"name": "error_message",
"kind": "required",
"type": "string",
"description": "Short description of what went wrong.",
"example": "",
"default": "The request failed due to a triple service interruption."
},
{
"name": "exception",
"kind": "required",
"type": "string",
"description": "The exception type.",
"example": ""
}
]
}
],
"isExpanded": true
}
]
}
],
"hasXCodeSamples": false,
"examples": {
"languages": [
{
"id": "example-0-curl",
"language": "curl",
"label": "cURL",
"code": "curl --request GET \\\n --url https://api.sandbox.tripleup.dev/partner/transactions/{id} \\\n --header 'accept: application/json'"
},
{
"id": "example-1-javascript",
"language": "javascript",
"label": "javascript",
"code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\n\nvar requestOptions = {\n method: 'GET',\n headers: myHeaders,\n redirect: 'follow'\n};\n\nfetch(\"https://api.sandbox.tripleup.dev/partner/transactions/{id}\", requestOptions)\n .then(response => response.text())\n .then(result => console.log(result))\n .catch(error => console.log('error', error));"
},
{
"id": "example-2-ruby",
"language": "ruby",
"label": "Ruby",
"code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api.sandbox.tripleup.dev/partner/transactions/{id}\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Get.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\n\nresponse = https.request(request)\nputs response.read_body\n"
},
{
"id": "example-3-python",
"language": "python",
"label": "Python",
"code": "import requests\nimport json\n\nurl = \"https://api.sandbox.tripleup.dev/partner/transactions/{id}\"\n\npayload = {}\nheaders = {\n 'accept': 'application/json',\n 'content-type': 'application/json'\n}\n\nresponse = requests.request(\"GET\", url, headers=headers, data=payload)\n\nprint(response.text)\n"
}
],
"selectedLanguageId": "example-0-curl"
},
"results": {
"languages": [
{
"id": "response-0-200",
"language": "200",
"code": "// Transaction\n{\n \"amount\": {},\n \"card_account_id\": \"triple-abc-123\",\n \"created_at\": \"2021-12-01T01:59:59.000Z\",\n \"currency_code\": \"USD\",\n \"debit\": false,\n \"description\": \"Pittsburgh Zoo\",\n \"external_id\": \"\",\n \"id\": \"triple-abc-123\",\n \"matching_status\": \"\",\n \"merchant_address\": {\n \"city\": \"PITTSBURGH\",\n \"complete\": \"7370 BAKER ST, STE 100\\nPITTSBURGH, PA 15206\",\n \"country_code\": \"US\",\n \"country_subdivision_code\": \"PA\",\n \"latitude\": 40.440624,\n \"longitude\": -79.995888,\n \"postal_code\": \"15206\",\n \"street_address\": \"7370 BAKER ST, STE 100\\n\"\n },\n \"merchant_category\": {\n \"code\": \"7998\",\n \"description\": \"Aquariums, Dolphinariums, Seaquariums, and Zoos\"\n },\n \"processor_mid\": \"9000012345\",\n \"processor_mid_type\": \"VISA_VMID\",\n \"reward_details\": [\n \"\"\n ],\n \"timestamp\": \"2021-12-01T01:59:59.000Z\",\n \"transaction_type\": \"PURCHASE\",\n \"updated_at\": \"2021-12-01T01:59:59.000Z\"\n}"
},
{
"id": "response-1-400",
"language": "400",
"code": "// TripleBadRequestError\n{\n \"status_code\": 0,\n \"content\": {\n \"details\": [\n \"\"\n ],\n \"error_message\": \"\",\n \"exception\": \"\"\n }\n}"
},
{
"id": "response-2-403",
"language": "403",
"code": "// TripleNotAuthenticatedError\n{\n \"status_code\": 0,\n \"content\": {\n \"details\": [\n \"\"\n ],\n \"error_message\": \"\",\n \"exception\": \"\"\n }\n}"
},
{
"id": "response-3-404",
"language": "404",
"code": "// TripleInvalidPathError\n{\n \"status_code\": 0,\n \"content\": {\n \"details\": [\n \"\"\n ],\n \"error_message\": \"\",\n \"exception\": \"\"\n }\n}"
},
{
"id": "response-4-409",
"language": "409",
"code": "// TripleIntegrityError\n{\n \"status_code\": 0,\n \"content\": {\n \"details\": [\n \"\"\n ],\n \"error_message\": \"\",\n \"exception\": \"\"\n }\n}"
},
{
"id": "response-5-415",
"language": "415",
"code": "// TripleUnsupportedMediaType\n{\n \"status_code\": 0,\n \"content\": {\n \"details\": [\n \"\"\n ],\n \"error_message\": \"\",\n \"exception\": \"\"\n }\n}"
},
{
"id": "response-6-422",
"language": "422",
"code": "// TripleUnprocessableEntity\n{\n \"status_code\": 0,\n \"content\": {\n \"details\": [\n \"\"\n ],\n \"error_message\": \"\",\n \"exception\": \"\"\n }\n}"
},
{
"id": "response-7-500",
"language": "500",
"code": "// TripleInternalServerError\n{\n \"status_code\": 0,\n \"content\": {\n \"details\": [\n \"\"\n ],\n \"error_message\": \"\",\n \"exception\": \"\"\n }\n}"
},
{
"id": "response-8-501",
"language": "501",
"code": "// TripleNotImplementedError\n{\n \"status_code\": 0,\n \"content\": {\n \"details\": [\n \"\"\n ],\n \"error_message\": \"\",\n \"exception\": \"\"\n }\n}"
},
{
"id": "response-9-503",
"language": "503",
"code": "// TripleServiceUnavailable\n{\n \"status_code\": 0,\n \"content\": {\n \"details\": [\n \"\"\n ],\n \"error_message\": \"\",\n \"exception\": \"\"\n }\n}"
}
],
"selectedLanguageId": "response-0-200"
}
},
"children": [
{
"text": ""
}
]
}