Skip to main content

Get Transaction By ID/UUID

Use this endpoint to retrieve transaction details using either ID or UUID as a query parameter. These values can be found in the transaction details section of the merchant portal or in the API response. This helps fetch transaction-specific data for auditing, reconciliation, support, or record-keeping purposes.

GETbaseUrl/api/v1/transactions/?id={id}

Headers​

  • Authorization: Bearer {{accessToken}} (Include the token obtained from the Authentication API)
  • Content-Type: application/json

You can use either id or uuid as a query parameter to fetch the transaction:

ParameterTypeRequiredDescription
idstringNoThe unique transaction ID to fetch
uuidstringNoThe unique UUID to fetch

Note: You must provide either id or uuid. If more than one is provided, the API will prioritize one.

Example Request — By Transaction ID

GET /api/v1/transactions/?id=1004 HTTP/1.1
Authorization: Bearer {{accessToken}}
Content-Type: application/json

Example Request — By UUID

GET /api/v1/transactions/?uuid=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Authorization: Bearer {{accessToken}}
Content-Type: application/json

Error Handling​

If the transaction is not found or another error occurs, you may receive an error response:

Example Error

{
  "status": "failed",
  "msg": "Transaction not found"
}

Usage Tips​

  1. Token Authorization: Always ensure your token is valid before making a request. Include it in the Authorization header in the format: Authorization: Bearer <accessToken>.
  2. Transaction ID: Use the correct and existing transaction ID to avoid errors.
  3. Reference: For more details on the response fields, refer to the Purchase API.