This API retrieves a list of purchase transactions based on specified query parameters and supports various query parameters for filtering and pagination. The start_date and end_date define the financial year range for transactions. The party_id allows filtering by a specific party, while the status parameter helps retrieve transactions based on payment status (Paid, Unpaid, or Partially Unpaid). The limit parameter controls the number of records returned, and skip determines how many records to ignore before fetching results, ensuring efficient data retrieval.
The API uses a GET request to fetch purchase transaction data. Since it does not require a request body, users can simply call the endpoint to retrieve the necessary information.
The API returns a response containing transaction details such as transaction ID, party name, invoice number, invoice amount, payment status, transaction type, and date. Additionally, it includes a success flag and a message confirming successful retrieval of the purchase transactions.
Request
Authorization
Add parameter in header
ApiKey
Example:
ApiKey: ********************
Query Params
Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl--location--request GET 'https://app.hisabkitab.co/third-party/purchase-transactions?start_date=01-04-2024&end_date=31-03-2025&party_id=1&status=1&limit=25&skip=0' \
--header'ApiKey: <api-key>'
Responses
🟢200List of Transactions
application/json
Body
Example
{"data":[{"transaction_id":1,"party_name":"Mahalaxmi","party_id":2,"phone_no":null,"invoice_number":"14","invoice_amount":11800,"payment_status":"Unpaid","transaction_type":"Purchase","date":"01-10-2024"},{"transaction_id":2,"party_name":"Ahana Dress Show Room","party_id":3,"phone_no":null,"invoice_number":"11","invoice_amount":118000,"payment_status":"Unpaid","transaction_type":"Purchase","date":"19-08-2024"}],"success":true,"message":"Purchase transactions retrieved successfully."}