All Transactions

This document will explain how to get transactions.

Endpoint

https://api.admaspay.com/api/v1/key-auth/transactions

Method : GET

Headers

Pass your api key as a bearer token in the request header to authorize this api.

Authorization : Bearer YOUR_API_KEY

Content-Type : application/json

Request Parameters

Parameter	Type	Required
page	Integer	No
limit	Integer	No
sort_by	String	NO
sort_dir	String	No
search_term	String	No
reference	String	No
from	Date	No
date	Date	No
types	String	No

Example Integration

Success Response:

{
    "total_pages": 6,
    "total": 12,
    "has_next": true,
    "is_last": false,
    "is_empty": false,
    "contents": [
        {
            "id": "5a31f985-6306-4ac2-a09b-df31d94daab9",
            "account": {
                "id": "bed5a3be-7863-4d93-b6f2-8559a290f4fb",
                "merchant_code": "k3jI75",
                "total_balance": 5000000.00
            },
            "reference": {
                "custom_ref": "null",
                "txn_ref": "QgOSu2V8AD",
                "payment_processor_ref": "tSLQx6W939"
            },
            "transaction_method": {
                "payment_method": {
                    "id": "5fdeedc2-1a85-492e-ab4b-841c95065bfe",
                    "type": "WALLET",
                    "name": "Telebirr",
                    "code": "TELEBIRR",
                    "account_number_length": 8,
                    "logo": "https://ekhcdc.org/wp-content/uploads/2023/12/photo_2021-05-10_22-48-53-telebirr_icon-1600x900.jpg",
                    "url": "https://www.ethiotelecom.et/telebirr",
                    "supported_currencies": [
                        "ETB"
                    ],
                    "status": "ACTIVE"
                },
                "currency": {
                    "id": "2f4c8878-554c-4ced-b875-9f5ae91f615b",
                    "name": "ETB",
                    "display_symbol": ".",
                    "name_code": "ETB"
                }
            },
            "against": {
                "customer": {
                    "id": "f0846f7b-5189-4f88-830d-b0e2c5c353d6",
                    "first_name": "John",
                    "last_name": "Doe",
                    "phone_number": "null"
                }
            },
            "amount": 300.00,
            "charge_amount": 0,
            "description": "null",
            "transaction_date": "2025-04-05T06:40:45.626456Z",
            "type": "RECEIVE",
            "status": "CHECKED_OUT"
        },
        {
            "id": "8b2675f5-7947-4e1b-8a03-4ad28a526124",
            "account": {
                "id": "bed5a3be-7863-4d93-b6f2-8559a290f4fb",
                "merchant_code": "k3jI75",
                "total_balance": 5000000.00
            },
            "reference": {
                "custom_ref": "null",
                "txn_ref": "CrccuBMzor",
                "payment_processor_ref": "d1FEXVb9nB"
            },
            "transaction_method": {
                "payment_method": {
                    "id": "5fdeedc2-1a85-492e-ab4b-841c95065bfe",
                    "type": "WALLET",
                    "name": "Telebirr",
                    "code": "TELEBIRR",
                    "account_number_length": 8,
                    "Logo":	"https://ekhcdc.org/wp-content/uploads/2023/12/photo_2021-05-10_22-48-53-telebirr_icon-1600x900.jpg",
                    "url": "https://www.ethiotelecom.et/telebirr",
                    "supported_currencies": [
                        "ETB"
                    ],
                    "status": "ACTIVE"
                },
                "currency": {
                    "id": "2f4c8878-554c-4ced-b875-9f5ae91f615b",
                    "name": "ETB",
                    "display_symbol": ".",
                    "name_code": "ETB"
                }
            },
            "against": {
                "customer": {
                    "id": "f0846f7b-5189-4f88-830d-b0e2c5c353d6",
                    "first_name": "John",
                    "last_name": "Doe",
                    "phone_number": "null"
                }
            },
            "amount": 300.00,
            "charge_amount": 0,
            "description": "null",
            "transaction_date": "2025-04-05T06:39:48.377771Z",
            "type": "RECEIVE",
            "status": "CHECKED_OUT"
        }
    ]
}

Error Response:

{
    "code": "invalid-api-key",
    "message": "Invalid api key"
}

For Detail error response go to Error codes.