Skip to main content
GET
/
api
/
auth
/
transactions
Get List of Transactions
curl --request GET \
  --url https://api.generect.com/api/auth/transactions/ \
  --header 'Authorization: <api-key>'
{
  "count": 8,
  "next": null,
  "previous": "http://localhost:8000/api/auth/transactions/?amount__lte=-5&created_at__range=2025-01-07T00%3A30%3A00%2C2025-12-31&limit=100",
  "limit": 100,
  "max_limit": 100,
  "offset": 5,
  "results": [
    {
      "id": "51a800b8-5c0c-4f0b-9c3c-459ea2a3fad6",
      "created_at": "2025-01-07T13:01:15.397996",
      "updated_at": "2025-01-07T13:01:58.195959",
      "status": "success",
      "balance_type": "leads_by_icp",
      "amount": -10,
      "description": "leads info by ICP",
      "after_balance": -2400
    },
    {
      "id": "eaea3124-c337-41f2-9258-4a043a7ea877",
      "created_at": "2025-01-07T11:27:54.628500",
      "updated_at": "2025-01-07T11:28:40.966949",
      "status": "success",
      "balance_type": "leads_by_icp",
      "amount": -10,
      "description": "leads info by ICP",
      "after_balance": -2390
    },
    {
      "id": "9f57c8e5-43c6-4baf-9777-7754fe481362",
      "created_at": "2025-01-07T00:31:06.785495",
      "updated_at": "2025-01-07T00:31:40.788266",
      "status": "success",
      "balance_type": "leads_by_icp",
      "amount": -10,
      "description": "leads info by ICP",
      "after_balance": -2380
    }
  ]
}

​
Filtering

The /api/auth/transactions/ endpoint allows you to filter transactions based on various properties. By applying filters directly in your request URL, you can narrow down results to meet specific criteria

​
Example:

To retrieve all transactions from the year 2025: /auth/transactions/?created_at__range=2025-01-01,2025-12-31

​
Available Parameters and Modifiers

Below is the list of parameters and the modifiers you can use for filtering:
Modifiers: exact, gt, gte, lt, lte, range
Example: ?created_at__range=2025-01-01,2025-12-31
Modifiers: exact
Example: ?status__exact=success
Modifiers: exact
Example: ?balance_type__exact=leads_by_icp
Modifiers: exact, gt, gte, lt, lte, range
Examples: ?amount__lt=-5
Modifiers: exact, gt, gte, lt, lte, range
Examples: ?after_balance__lte=500
Modifier Descriptions:
  • exact: Matches the exact value (==)
  • gt: Greater than (>)
  • gte: Greter than or equal to (>=)
  • lt: Lower than (<)
  • lte: Lower than or equal to (<=)
  • range: Filters values between x and y (number or date). Syntax: x,y

​
Date

  • Date: yyyy-mm-dd
    Example: 2025-01-01
  • Date and Time: yyyy-mm-ddTHH:MM:SS.ssssss
    Example: 2025-01-01T02:03:04.000000

Authorizations

​
Authorization
string
header
required

Use 'Token ' as the value

Query Parameters

​
limit
string

Limit of transactions in result

Example:

"100"

​
offset
string

Offset in list of transactions

Example:

"0"

Response

200 - application/json

200

​
count
number
Example:

8

​
limit
number
Example:

100

​
max_limit
number
Example:

100

​
next
unknown
​
offset
number
Example:

5

​
previous
string
Example:

"https://api.generect.com/api/auth/transactions/?amount__lte=-5&created_at__range=2025-01-07T00%3A30%3A00%2C2025-12-31&limit=100"

​
results
object[]
Example:
[
  {
    "id": "51a800b8-5c0c-4f0b-9c3c-459ea2a3fad6",
    "created_at": "2025-01-07T13:01:15.397996",
    "updated_at": "2025-01-07T13:01:58.195959",
    "status": "success",
    "balance_type": "leads_by_icp",
    "amount": -10,
    "description": "leads info by ICP",
    "after_balance": -2400
  },
  {
    "id": "eaea3124-c337-41f2-9258-4a043a7ea877",
    "created_at": "2025-01-07T11:27:54.628500",
    "updated_at": "2025-01-07T11:28:40.966949",
    "status": "success",
    "balance_type": "leads_by_icp",
    "amount": -10,
    "description": "leads info by ICP",
    "after_balance": -2390
  },
  {
    "id": "9f57c8e5-43c6-4baf-9777-7754fe481362",
    "created_at": "2025-01-07T00:31:06.785495",
    "updated_at": "2025-01-07T00:31:40.788266",
    "status": "success",
    "balance_type": "leads_by_icp",
    "amount": -10,
    "description": "leads info by ICP",
    "after_balance": -2380
  }
]