Get subscription transactions

GET

/data/v1/subscription/{subscriptionId}

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.

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

Bodyapplication/json

🟠400

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location '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": "PEN",
        "ice": 0,
        "iva": 0,
        "subtotalIva": 0,
        "subtotalIva0": 0
    },
    "bin_info_object": {
        "bank": "BANCO",
        "bin": "521892",
        "brand": "MASTERCARD",
        "info": {
            "country": {
                "alpha3": "PE",
                "name": "PERU"
            },
            "type": "credit"
        },
        "originalBinFullLength": "52189210",
        "validBin8": true
    },
    "card_holder_name": "Sofia wallis",
    "card_type": "credit",
    "contact_details_object": {
        "email": "sofiawallis@gmail.com",
        "firstName": "Sofia",
        "lastName": "wallis"
    },
    "create_timestamp": 1760313600,
    "day_of_month": -2,
    "day_of_week": "-",
    "expiry_month": "06",
    "expiry_year": "26",
    "last_charge_timestamp": 1760313600,
    "last_four_digit_code": "9969",
    "merchant_code": "20000000106913436000",
    "merchant_country_name": "Peru",
    "metadata_object": {
        "ownerId": "c8SNs23SJ976ykkxn",
        "ownerType": "user"
    },
    "month": "-",
    "periodicity_type": "custom",
    "plan_name": "Justo",
    "provider_name": "kushki",
    "reference_transaction_code": "65c4f3df2880446e8e8f8b290f4533f8",
    "start_timestamp": 1760313600,
    "subscription_code": "1725484000756000",
    "transactions": [
        {
            "_id": "491915787351730000",
            "acquirer_bank_name": "Banco Internacional",
            "approval_code": "676300",
            "approved_transaction_amount": 600,
            "bin_code": "55828400",
            "card_country_code": "PE",
            "card_country_name": "Peru",
            "card_holder_name": "Carla Andrade",
            "card_type": "credit",
            "contact_detail": {
                "email": "vanessa.montalvo@kushkipagos.com",
                "first_name": "Carla",
                "last_name": "Andrade",
                "phone": "+51912345678"
            },
            "contact_email": "vanessa.montalvo@kushkipagos.com",
            "core_source_name": "KUSHKI",
            "country_name": "Peru",
            "create_timestamp": 1774459991000,
            "currency_code": "PEN",
            "foreign_card_indicator": false,
            "ice_value": 0,
            "issuing_bank_name": "BANCO",
            "iva_value": 7.42,
            "kushki_info_origin_type": "SUBSCRIPTION",
            "last_four_digit_code": "0407",
            "merchant_code": "20000000100311392000",
            "merchant_name": "BRANCH PERU",
            "metadata_object": {
                "amount": 600,
                "description": "Pago ext_38N5MqnRAcHDqnX8g en Saca la resaca",
                "email": "vanessa.montalvo@kushkipagos.com",
                "externalId": "38N5MqnRAcHDqnX8g",
                "fraudData": {
                    "baseURL": "https://www.testingmm.com",
                    "buyerName": "Vanessa Montalvo",
                    "countryCode": "PEN",
                    "deliveryType": "delivery",
                    "deviceFingerprint": "4997a0af5889fa4ea6c5651a9b6d500e",
                    "deviceId": "jVFrKTxVbOHVxHcMhLWqQSOt1blJywPXncCHGaFpW6Yz7VPFtR",
                    "email": "vanessa.montalvo@kushkipagos.com",
                    "ip": "177.234.217.99",
                    "phone": "+51912345678",
                    "websiteName": "testing vane2"
                },
                "orderCode": "#20854966-02",
                "paymentAttemptId": "ppat_c4dfcc78-106a-48e2-bc5c-8bd4dbf91664",
                "paymentId": "ppay_e46bdc89-305d-4a4c-9383-bfa95f11af1f",
                "storeId": "uh43qNzZAmTSZZqhk",
                "websiteId": "pd3jRHYQTLtgrsE7j"
            },
            "payment_brand_name": "Mastercard",
            "payment_method_type": "CARD",
            "payment_submethod_type": "CARD VPC",
            "prepaid_indicator": false,
            "processor_name": "MC Processor",
            "processor_type": "aggregator_formal",
            "recap_code": "325447",
            "reference_transaction_code": "03c65353-361c-4a99-96da-e0c64c08484a",
            "request_amount": 600,
            "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": 49.43,
            "sync_mode_type": "online",
            "ticket_code": "754812488659082161",
            "transaction_code": "526505389111678151",
            "transaction_status_type": "APPROVED",
            "transaction_type": "SALE"
        }
    ]
}

Modified at 2026-07-29 16:21:33

Subscription Transactions

Settlement

Get subscription transactions

Default behavior#

Request

Responses

Default behavior