Skip to main content
GET
/
transaction
/
{ticket}
curl --request GET 'https://api-empresas.staging.topup.com.co/production/api/v1/transaction/{ticket}' \
--header 'Token-Top: your_auth_token' \
--header 'Authorization: Basic your_auth_key' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ticket": "1740ed7e-bbab-11ee-8335-02530a7dec0f"
}'

{
    "code": "01",
    "status": "SUCCESS",
    "data": {
        "ticket": "saKqzi9Sw9knrgc",
        "reference": "1T11SKv97GRQ3GnqetKXaG4sY",
        "amount": 3000,
        "currency": "COP",
        "type_transaction": "Recaudo",
        "customer": {
            "email": "user-test@gmail.com",
            "full_name": "User Test",
            "legal_doc": 3066000010,
            "phone_code": "57",
            "phone_number": 3066000002,
            "legal_doc_type": "CC"
        },
        "status": "REJECTED",
        "response_message": "Transacción rechazada",
        "date": "2025-08-18 23:40:14",
        "cus": "1qslsGreOPfa1n9U",
        "metadata": []
    }
}
Search for transactions using various filters 
curl --request GET 'https://api-empresas.staging.topup.com.co/production/api/v1/transaction/{ticket}' \
--header 'Token-Top: your_auth_token' \
--header 'Authorization: Basic your_auth_key' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ticket": "1740ed7e-bbab-11ee-8335-02530a7dec0f"
}'

{
    "code": "01",
    "status": "SUCCESS",
    "data": {
        "ticket": "saKqzi9Sw9knrgc",
        "reference": "1T11SKv97GRQ3GnqetKXaG4sY",
        "amount": 3000,
        "currency": "COP",
        "type_transaction": "Recaudo",
        "customer": {
            "email": "user-test@gmail.com",
            "full_name": "User Test",
            "legal_doc": 3066000010,
            "phone_code": "57",
            "phone_number": 3066000002,
            "legal_doc_type": "CC"
        },
        "status": "REJECTED",
        "response_message": "Transacción rechazada",
        "date": "2025-08-18 23:40:14",
        "cus": "1qslsGreOPfa1n9U",
        "metadata": []
    }
}

​
Required Headers

​
Token-Top
string
required
Your merchant authentication token
​
Content-Type
string
required
Must be “application/json”

​
Request Body Parameters

​
ticket
string
Transaction ticket ID or Reference

​
Response

​
data
array
​
pagination
object
Pagination information
​
pagination.total
integer
Total number of records
​
pagination.page
integer
Current page number
​
pagination.limit
integer
Number of records per page
​
pagination.pages
integer
Total number of pages

Authorizations

​
Token-Top
string
header
required

Merchant authentication token

​
Authorization
string
header
required

Basic authentication with username and password

Response

Successful response

​
data
object[]
​
pagination
object