Transactions

All transaction endpoints require a valid Bearer token in the Authorization header.

Get transaction history

GET /v2/transaction_history Returns a paginated list of the authenticated user’s transactions. Supports server-side search and infinite scroll pagination. The client uses cursor-based pagination, loading the next page when the user scrolls to the bottom of the list. Transactions with a null cart field are filtered out in the UI.

Query parameters

page

integer

default:"1"

The page number to fetch.

string

Optional search term to filter transactions by merchant name or other fields.

Response

transactions

object

Show properties

data

object[]

Array of transaction objects.

Show transaction properties

uuid

string

The transaction’s unique identifier. Used as txn_uid in payment request actions.

status

string

Transaction status. Common values: "Completed", "Awaiting", "Failed". Transactions with status "Awaiting" surface as pending payment requests.

subtotal

string

The transaction amount as a decimal string.

cart

object | null

Cart details for the transaction. null for transactions that should be hidden from the history list.

merchant

object

Show properties

business_name

string

The merchant’s registered business name.

picture

string

URL of the merchant’s logo.

cashier

object

Show properties

first_name

string

The cashier’s first name.

last_name

string

The cashier’s last name.

created_at

string

ISO 8601 timestamp when the transaction was created. Used to group transactions by date.

updated_at

string

ISO 8601 timestamp when the transaction was last updated.

current_page

integer

The current page number.

last_page

integer

The total number of pages.

per_page

integer

The number of items per page.

total

integer

The total number of transactions.

curl "https://dossapp.com/api/v2/transaction_history?page=1&search=" \
  -H "Authorization: Bearer {token}" \
  -H "Accept: application/json"

Get dashboard

GET /v2/doss_dashboard Returns the home screen summary, including wallet balance and a recent transaction list. This endpoint is fetched on every home screen mount and refreshed on pull-to-refresh.

Response

wallet_dashboard

object

Show properties

balance

string

The user’s current wallet balance as a decimal string.

wallets

object[]

Array of wallet objects associated with the account.

transactions

object

Show properties

data

object[]

Recent transactions. Same shape as the transaction objects returned by GET /v2/transaction_history.

curl https://dossapp.com/api/v2/doss_dashboard \
  -H "Authorization: Bearer {token}" \
  -H "Accept: application/json"

Endpoints

Get transaction history

Query parameters

Response

Get dashboard

Response

Build docs developers (and LLMs) love

Endpoints

​Get transaction history

​Query parameters

​Response

​Get dashboard

​Response

Build docs developers (and LLMs) love

Get transaction history

Query parameters

Response

Get dashboard

Response