GET: Account Transactions - DarajaPay API Documentation

Fetch your account transactions

GET https://darajapay.com/api/v1/transactions

Query Parameters

Name	Type	Description
page	Integer	The page number that you want to fetch data for
per	Integer	The total records per page

Headers

Name	Type	Description
Authorization*	String	Basic authToken

200: OK Results

{
  "transactions": [
    {
      "id": 451,
      "account_id": 183,
      "invoice_id": null,
      "transaction_type": "service_charge",
      "description": "Received KES 50 from ",
      "amount": -6,
      "transaction_reference": "EB7C4Z7RXC",
      "provider_reference": "cost_EB7C4Z7RXC",
      "goal_id": null,
      "gateway": "sasapay",
      "cost": 6,
      "wallet_balance": 6775,
      "transaction_name": "Transaction Fee",
      "created_at": "2024-01-19T15:13:11.203273Z",
      "updated_at": "2024-01-19T15:13:11.202741Z"
    },
    {
      "id": 450,
      "account_id": 183,
      "invoice_id": null,
      "transaction_type": "outbound_payment",
      "description": "Received KES 50 from ",
      "amount": 50,
      "transaction_reference": "EB7C4Z7RXC",
      "provider_reference": "EB7C4Z7RXC",
      "goal_id": null,
      "gateway": "sasapay",
      "cost": 6,
      "wallet_balance": 6775,
      "transaction_name": "Outbound Payment",
      "created_at": "2024-01-19T15:13:11.198821Z",
      "updated_at": "2024-01-19T15:13:11.19815Z"
    }
  ],
  "pagination": {
    "count": 284,
    "next_page": 3,
    "num_pages": 142,
    "page": 2,
    "per": 2,
    "prev_page": 1
  }
}

From the response you can pick the next_page and prev_page params to help you navigate easily, You also get a count of all the available transactions

Code Examples

PHP

<?php
$url = 'https://darajapay.com/api/v1/transactions';

$headers = array(
    'Content-Type: application/json',
    'Authorization: Basic YOUR_API_KEY'
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Python

import requests

url = "https://darajapay.com/api/v1/transactions"
headers = {
    "Authorization": "Basic YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

Node.js

const axios = require('axios');

const config = {
    headers: {
        'Authorization': 'Basic YOUR_API_KEY'
    }
};

axios.get('https://darajapay.com/api/v1/transactions', config)
    .then(response => {
        console.log(response.data);
    })
    .catch(error => {
        console.error(error);
    });

Java

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class TransactionsExample {
    public static void main(String[] args) {
        String url = "https://darajapay.com/api/v1/transactions";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Authorization", "Basic YOUR_API_KEY")
            .GET()
            .build();

        client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
            .thenApply(HttpResponse::body)
            .thenAccept(System.out::println)
            .join();
    }
}

C#

using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var client = new HttpClient();
        var url = "https://darajapay.com/api/v1/transactions";
        
        client.DefaultRequestHeaders.Add("Authorization", "Basic YOUR_API_KEY");
        
        var response = await client.GetAsync(url);
        var result = await response.Content.ReadAsStringAsync();
        
        Console.WriteLine(result);
    }
}

Go

package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    url := "https://darajapay.com/api/v1/transactions"
    
    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("Authorization", "Basic YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

Ruby

require 'uri'
require 'net/http'

url = URI("https://darajapay.com/api/v1/transactions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = "Basic YOUR_API_KEY"

response = http.request(request)
puts response.read_body