Get subscription transactions

GET

/data/v1/subscription/{subscriptionId}

This functionality is available for the following models:
☑ Acquirer
☑ Aggregator

Retrieves the details of a subscription and the list of transactions charged
under it, filtered by a date range.

Use the start and end query parameters to define the billing period you want
to inspect. Use size to limit the number of transactions returned.

WARNING

Default behavior
size defaults to 100 transactions.
start defaults to 5 days before the request timestamp.
end defaults to the moment the request is made.

Request

Path Params

Query Params

Header Params

Responses

🟢200

application/json

Body

🟠400

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api-uat.kushkipagos.com/data/v1/subscription/177493387604666666?size=10&start=2026-01-30&end=2026-02-28' \
--header 'Private-Merchant-Id;'

Response Example

200 - GL - Subscription with transactions

{
    "active_indicator": true,
    "amount_object": {
        "currency": "COP",
        "ice": 0,
        "iva": 0,
        "subtotalIva": 0,
        "subtotalIva0": 48000
    },
    "bin_info_object": {
        "bank": "BANCO DE BOGOTA",
        "bin": "545195",
        "brand": "MASTERCARD",
        "info": {
            "country": {
                "alpha3": "COL",
                "name": "Colombia"
            },
            "type": "credit"
        },
        "originalBinFullLength": "54519515",
        "validBin8": true
    },
    "card_holder_name": "John Doe",
    "card_type": "credit",
    "contact_details_object": {
        "email": "user@example.com",
        "firstName": "John",
        "lastName": "Doe"
    },
    "create_timestamp": 1760313600,
    "day_of_month": -2,
    "day_of_week": "-",
    "expiry_month": "06",
    "expiry_year": "26",
    "last_charge_timestamp": 1760313600,
    "last_four_digit_code": "5480",
    "merchant_code": "20000000105929933000",
    "merchant_country_name": "Colombia",
    "metadata_object": {
        "ownerId": "c8SNs23SJ976ykkxn",
        "ownerType": "user"
    },
    "month": "-",
    "periodicity_type": "custom",
    "plan_name": "Premium",
    "provider_name": "kushki",
    "reference_transaction_code": "65c4f3df2880446e8e8f8b290f4533f8",
    "start_timestamp": 1760313600,
    "subscription_code": "1725484000756000",
    "transactions": [
        {
            "_id": "491915787351730000",
            "acquirer_bank_name": "IRIS CF",
            "approval_code": "676300",
            "approved_transaction_amount": 48000,
            "bin_code": "54519515",
            "card_country_code": "CO",
            "card_country_name": "Colombia",
            "card_holder_name": "John Doe",
            "card_type": "credit",
            "contact_detail": {
                "email": "user@example.com",
                "first_name": "John",
                "last_name": "Doe",
                "phone": "+573012345678"
            },
            "contact_email": "user@example.com",
            "core_source_name": "KUSHKI",
            "country_name": "Colombia",
            "create_timestamp": 1774459991000,
            "currency_code": "COP",
            "foreign_card_indicator": false,
            "ice_value": 0,
            "issuing_bank_name": "BANCO DE BOGOTA",
            "iva_value": 2000,
            "kushki_info_origin_type": "SUBSCRIPTION",
            "last_four_digit_code": "0407",
            "merchant_code": "20000000105929933000",
            "merchant_name": "BRANCH CO101",
            "metadata_object": {
                "amount": 48000,
                "description": "Pago suscripción Premium",
                "email": "user@example.com",
                "externalId": "EXT123456CO"
            },
            "payment_brand_name": "Mastercard",
            "payment_method_type": "CARD",
            "payment_submethod_type": "CARD VPC",
            "prepaid_indicator": false,
            "processor_name": "Kushki Acquirer Processor",
            "processor_type": "gateway",
            "recap_code": "325447",
            "reference_transaction_code": "03c65353-361c-4a99-96da-e0c64c08484a",
            "request_amount": 48000,
            "response_code": "000",
            "response_description": "Transacción aprobada",
            "subscription_code": "1725484000756000",
            "subscription_metadata_object": {
                "ownerId": "66d8c907c821c0b527ac80ac",
                "ownerType": "user"
            },
            "subscription_trigger_type": "onDemand",
            "subtotal_iva0_amount": 0,
            "subtotal_iva_amount": 46000,
            "sync_mode_type": "online",
            "ticket_code": "754812488659082161",
            "transaction_code": "526505389111678151",
            "transaction_status_type": "APPROVED",
            "transaction_type": "SALE"
        }
    ]
}

Modified at 2026-04-16 17:35:40

Capture an authorized payment

Get gateway status

Get subscription transactions

This functionality is available for the following models:#

Default behavior#

Request

Responses

This functionality is available for the following models:

Default behavior