Transactions

curl "{{host}}/api/v1/transactions?page=1&limit=25&transaction_type=DEBIT" \
  -H "Authorization: Bearer <token>"

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
)

type Transaction struct {
    ID                  int      `json:"id"`
    WalletID            int      `json:"wallet_id"`
    CurrencyID          int      `json:"currency_id"`
    Amount              float64  `json:"amount"`
    TransactionType     string   `json:"transaction_type"`
    Status              string   `json:"status"`
    SourceCurrency      *string  `json:"source_currency"`
    DestinationCurrency *string  `json:"destination_currency"`
    ForexRate           *float64 `json:"forex_rate"`
    ConversionCharges   *float64 `json:"conversion_charges"`
    Remarks             string   `json:"remarks"`
    CreatedAt           string   `json:"created_at"`
}

func main() {
    req, _ := http.NewRequest("GET", "{{host}}/api/v1/transactions?limit=25", nil)
    req.Header.Set("Authorization", "Bearer <token>")

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

    // Read pagination from headers
    fmt.Println("Total:", resp.Header.Get("X-Total-Count"))
    fmt.Println("Page:", resp.Header.Get("X-Page"))

    var txns []Transaction
    json.NewDecoder(resp.Body).Decode(&txns)

    for _, t := range txns {
        fmt.Printf("[%s] %s %.2f — %s\n", t.Status, t.TransactionType, t.Amount, t.Remarks)
    }
}

{
  "error": {
    "name": "BadRequestError",
    "code": "BAD_REQUEST",
    "message": "Invalid transaction type. Must be CREDIT or DEBIT"
  }
}

{
  "error": {
    "name": "UnauthorizedError",
    "code": "UNAUTHORIZED",
    "message": "Authorization header required"
  }
}

{
  "error": {
    "name": "ForbiddenError",
    "code": "FORBIDDEN",
    "message": "IP address not authorized"
  }
}

{
  "error": {
    "name": "InternalServerError",
    "code": "INTERNAL_SERVER_ERROR",
    "message": "Failed to retrieve transactions"
  }
}

curl "{{host}}/api/v1/transactions/456" \
  -H "Authorization: Bearer <token>"

req, _ := http.NewRequest("GET", "{{host}}/api/v1/transactions/456", nil)
req.Header.Set("Authorization", "Bearer <token>")

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

var txn Transaction
json.NewDecoder(resp.Body).Decode(&txn)

fmt.Printf("[%s] %s %.2f — %s\n", txn.Status, txn.TransactionType, txn.Amount, txn.Remarks)

{
  "error": {
    "name": "BadRequestError",
    "code": "BAD_REQUEST",
    "message": "Invalid transaction ID"
  }
}

{
  "error": {
    "name": "NotFoundError",
    "code": "NOT_FOUND",
    "message": "Transaction not found"
  }
}

{
  "error": {
    "name": "UnauthorizedError",
    "code": "UNAUTHORIZED",
    "message": "Authorization header required"
  }
}

{
  "error": {
    "name": "ForbiddenError",
    "code": "FORBIDDEN",
    "message": "IP address not authorized"
  }
}