Search transactions and recipients

GET

/v1/search

Unified search across ledger transactions and recent recipients. Query q required; optional account_id UUID scope and limit.

Authentication: Bearer JWT (user session).

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Responses

🟢200

application/json

Search results

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠409Conflict

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/search?q=&limit=&account_id=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "query": "string",
    "transactions": {
        "items": [
            {
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "account_id": "449e7a5c-69d3-4b8a-aaaf-5c9b713ebc65",
                "type": "credit",
                "purpose": "string",
                "amount": "string",
                "currency": "string",
                "balance_after": "string",
                "description": "string",
                "transfer_id": "d4a2d8dd-7def-4545-a062-761683b9aa05",
                "transfer_type": "string",
                "card_id": "66f6e46c-f6a1-4af8-a1bd-49666bc01304",
                "mcc": "string",
                "metadata": {},
                "created_at": "2019-08-24T14:15:22.123Z"
            }
        ]
    },
    "recent_recipients": {
        "items": [
            {
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "transfer_type": "string",
                "payload": {},
                "last_used_at": "2019-08-24T14:15:22.123Z",
                "last_transfer_id": "e3167d27-069f-4c53-b3ba-2115b9d8a0f4"
            }
        ]
    }
}

Modified at 2026-06-23 04:24:01

List recent transfer recipients

List available transfer types