List Invoices

GET {{baseUrl}}/v1/invoices?name=<string>&addresses=[object Object],[object Object]&business_vat_id=<string>&created_at=<integer>&default_payment_method=<string>&delinquent=<boolean>&description=<string>&discount=[object Object]&email=<string>&ewallet=<string>&id=<string>&invoice_prefix=<string>&metadata=[object Object]&payment_methods=[object Object]&phone_number=<string>&subscriptions=[object Object],[object Object]&date=<string>&due_date=<string>&ending_before=<string>&limit=<string>&starting_after=<string>&subscription=<boolean>

Retrieve the basic data of an invoice, with individual invoice lines.

Request Params

HEADERS

RESPONSES

status: OK

{"data":[{"id":"\u003cstring\u003e","attempt_count":"\u003cnumber\u003e","billing":"\u003cstring\u003e","billing_reason":"\u003cstring\u003e","created_at":"\u003cnumber\u003e","discount":{"coupon":{"amount_off":"\u003cnumber\u003e","created":"\u003cnumber\u003e","currency":"GYD","description":"\u003cstring\u003e","discount_duration_in_uses":"\u003cnumber\u003e","discount_valid_until":"\u003cnumber\u003e","discount_validity_in_months":"\u003cnumber\u003e","duration":"forever","duration_in_months":"\u003cnumber\u003e","id":"\u003cstring\u003e","max_redemptions":"\u003cnumber\u003e","metadata":{},"percent_off":3,"redeem_by":"\u003cnumber\u003e","times_redeemed":"\u003cnumber\u003e","valid":"\u003cboolean\u003e"},"end":"\u003cnumber\u003e","id":"\u003cstring\u003e","number_of_uses":"\u003cnumber\u003e","start":"\u003cnumber\u003e","subscription":"\u003cstring\u003e","valid":"\u003cboolean\u003e"},"currency":"ET","customer":"\u003cstring\u003e","days_until_due":"\u003cnumber\u003e","description":"\u003cstring\u003e","due_date":"\u003cstring\u003e","metadata":{},"payment_fields":{},"payment_method":"\u003cstring\u003e","statement_descriptor":"\u003cstring\u003e","subscription":"\u003cstring\u003e","tax_percent":"\u003cnumber\u003e","payment":{"address":{"canton":"\u003cstring\u003e","city":"\u003cstring\u003e","country":"EH","created_at":"\u003cnumber\u003e","district":"\u003cstring\u003e","id":"\u003cstring\u003e","line_1":"\u003cstring\u003e","line_2":"\u003cstring\u003e","line_3":"\u003cstring\u003e","metadata":{},"name":"\u003cstring\u003e","phone_number":"\u003cstring\u003e","state":"\u003cstring\u003e","zip":"\u003cstring\u003e"},"amount":0,"auth_code":"\u003cstring\u003e","cancel_reason":"\u003cstring\u003e","captured":true,"complete_payment_url":"\u003cstring\u003e","country_code":"OM","created_at":"\u003cinteger\u003e","currency_code":"NPR","customer_token":"\u003cstring\u003e","description":"\u003cstring\u003e","dispute":{"id":"\u003cstring\u003e","token":"\u003cstring\u003e","status":"LOS","amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e","dispute_category":"\u003cstring\u003e","dispute_reason_description":"\u003cstring\u003e","original_transaction_currency":"GBP","original_transaction_amount":"\u003cnumber\u003e","original_dispute_amount":"\u003cnumber\u003e","original_dispute_currency":"/AED","original_transaction_id":"\u003cstring\u003e","ewallet_id":"\u003cstring\u003e","central_processing_date":"\u003cnumber\u003e","created_at":"\u003cnumber\u003e","updated_at":"\u003cnumber\u003e","due_date":"\u003cnumber\u003e","payment_method":"\u003cstring\u003e","payment_method_data":{},"rate":"\u003cnumber\u003e","evidence":"\u003cstring\u003e","evidence_reason_code":"\u003cstring\u003e","pre_dispute":"\u003cboolean\u003e","arn":"\u003cstring\u003e"},"error_code":"\u003cstring\u003e","error_payment_url":"\u003cstring\u003e","escrow":{},"ewallet_id":"\u003cstring\u003e","ewallets":[{"ewallet_id":"\u003cstring\u003e","amount":"\u003cnumber\u003e","percent":"\u003cnumber\u003e","refunded_amount":"\u003cnumber\u003e"}],"expiration":0,"failure_code":"\u003cstring\u003e","failure_message":"\u003cstring\u003e","fixed_side":"\u003cstring\u003e","flow_type":"\u003cstring\u003e","fx_rate":1,"group_payment":"\u003cstring\u003e","id":"\u003cstring\u003e","initiation_type":"\u003cstring\u003e","instructions":[{"name":"\u003cstring\u003e","steps":[{"step":"\u003cstring\u003e"}]}],"invoice":"\u003cstring\u003e","is_partial":false,"merchant_reference_id":"\u003cstring\u003e","merchant_requested_amount":"\u003cstring\u003e","merchant_requested_currency":"\u003cstring\u003e","metadata":{},"mid":"\u003cstring\u003e","next_action":"3d_verification","order":"\u003cstring\u003e","original_amount":0,"outcome":{"network_status":"approved_by_network","payment_flow_type":"eWallet","payment_options":{"address":{"canton":"\u003cstring\u003e","city":"\u003cstring\u003e","country":"BH","created_at":"\u003cnumber\u003e","district":"\u003cstring\u003e","id":"\u003cstring\u003e","line_1":"\u003cstring\u003e","line_2":"\u003cstring\u003e","line_3":"\u003cstring\u003e","metadata":{},"name":"\u003cstring\u003e","phone_number":"\u003cstring\u003e","state":"\u003cstring\u003e","zip":"\u003cstring\u003e"},"amount_range_per_currency":[{"maximum_amount":"\u003cnumber\u003e","minimum_amount":"\u003cnumber\u003e","currency":"AUD"}],"bin_details":{"brand":"\u003cstring\u003e","bin_number":"\u003cstring\u003e","type":"\u003cstring\u003e","issuer":"\u003cstring\u003e","country":"WF","level":"\u003cstring\u003e"},"category":"cash","conditions":[{"description":"\u003cstring\u003e","element_name":"\u003cstring\u003e","operator":"\u003cstring\u003e","threshold_value":"\u003cstring\u003e"}],"country":"JP","currencies":["HNL"],"customer":{"name":"\u003cstring\u003e","addresses":[{"canton":"\u003cstring\u003e","city":"\u003cstring\u003e","country":"ZA","created_at":"\u003cnumber\u003e","district":"\u003cstring\u003e","id":"\u003cstring\u003e","line_1":"\u003cstring\u003e","line_2":"\u003cstring\u003e","line_3":"\u003cstring\u003e","metadata":{},"name":"\u003cstring\u003e","phone_number":"\u003cstring\u003e","state":"\u003cstring\u003e","zip":"\u003cstring\u003e"}],"business_vat_id":"\u003cstring\u003e","created_at":"\u003cinteger\u003e","default_payment_method":"\u003cstring\u003e","delinquent":"\u003cboolean\u003e","description":"\u003cstring\u003e","discount":{"coupon":{"amount_off":"\u003cnumber\u003e","created":"\u003cnumber\u003e","currency":"KHR","description":"\u003cstring\u003e","discount_duration_in_uses":"\u003cnumber\u003e","discount_valid_until":"\u003cnumber\u003e","discount_validity_in_months":"\u003cnumber\u003e","duration":"repeating","duration_in_months":"\u003cnumber\u003e","id":"\u003cstring\u003e","max_redemptions":"\u003cnumber\u003e","metadata":{},"percent_off":73,"redeem_by":"\u003cnumber\u003e","times_redeemed":"\u003cnumber\u003e","valid":"\u003cboolean\u003e"},"customer":"\u003cstring\u003e","end":"\u003cnumber\u003e","id":"\u003cstring\u003e","number_of_uses":"\u003cnumber\u003e","start":"\u003cnumber\u003e","subscription":"\u003cstring\u003e","valid":"\u003cboolean\u003e"},"email":"\u003cstring\u003e","ewallet":"\u003cstring\u003e","id":"\u003cstring\u003e","invoice_prefix":"\u003cstring\u003e","metadata":{},"payment_methods":{"data":[{"id":"\u003cstring\u003e","type":"\u003cstring\u003e","category":"cash","metadata":{},"image":"\u003cstring\u003e","webhook_url":"\u003cstring\u003e","supporting_documentation":"\u003cstring\u003e","next_action":"3d_verification","bic_swift":"\u003cstring\u003e","account_last4":"\u003cstring\u003e"}],"has_more":"\u003cboolean\u003e","total_count":"\u003cinteger\u003e","url":"\u003cstring\u003e"},"phone_number":"\u003cstring\u003e","subscriptions":[{"billing":"\u003cstring\u003e","billing_cycle_anchor":"\u003cstring\u003e","cancel_at_period_end":"\u003cboolean\u003e","canceled_at":"\u003cnumber\u003e","created_at":"\u003cnumber\u003e","current_period_end":"\u003cnumber\u003e","current_period_start":"\u003cnumber\u003e","customer_token":"\u003cstring\u003e","days_until_due":"\u003cnumber\u003e","discount":{"coupon":{"amount_off":"\u003cnumber\u003e","created":"\u003cnumber\u003e","currency":"NGN","description":"\u003cstring\u003e","discount_duration_in_uses":"\u003cnumber\u003e","discount_valid_until":"\u003cnumber\u003e","discount_validity_in_months":"\u003cnumber\u003e","duration":"forever","duration_in_months":"\u003cnumber\u003e","id":"\u003cstring\u003e","max_redemptions":"\u003cnumber\u003e","metadata":{},"percent_off":100,"redeem_by":"\u003cnumber\u003e","times_redeemed":"\u003cnumber\u003e","valid":"\u003cboolean\u003e"},"end":"\u003cnumber\u003e","id":"\u003cstring\u003e","number_of_uses":"\u003cnumber\u003e","start":"\u003cnumber\u003e","subscription":"\u003cstring\u003e","valid":"\u003cboolean\u003e"},"ended_at":"\u003cnumber\u003e","id":"\u003cstring\u003e","metadata":{},"payment_fields":{},"payment_method":"\u003cstring\u003e","payout_fields":{},"simultaneous_invoice":"\u003cboolean\u003e","status":"canceled","subscription_items":{"data":[{"created":"\u003cnumber\u003e","id":"\u003cstring\u003e","metadata":{},"plan":{"active":"\u003cboolean\u003e","aggregate_usage":"last_during_period","amount":"\u003cnumber\u003e","billing_scheme":"tiered","created_at":"\u003cnumber\u003e","currency":"NGN","id":"\u003cstring\u003e","interval":"day","interval_count":"\u003cnumber\u003e","metadata":{},"nickname":"\u003cstring\u003e","product":{"active":"\u003cboolean\u003e","attributes":["\u003cstring\u003e"],"created_at":"\u003cnumber\u003e","description":"\u003cstring\u003e","id":"\u003cstring\u003e","images":["\u003cstring\u003e"],"metadata":{},"name":"\u003cstring\u003e","package_dimensions":{"height":"\u003cnumber\u003e","length":"\u003cnumber\u003e","weight":"\u003cnumber\u003e","width":"\u003cnumber\u003e"},"shippable":"\u003cboolean\u003e","skus":[{"active":"\u003cboolean\u003e","attributes":{},"created_at":"\u003cnumber\u003e","currency":"SOS","id":"\u003cstring\u003e","image":"\u003cstring\u003e","inventory":{},"metadata":{},"package_dimensions":{"height":"\u003cnumber\u003e","length":"\u003cnumber\u003e","weight":"\u003cnumber\u003e","width":"\u003cnumber\u003e"},"price":"\u003cnumber\u003e","product":"\u003cstring\u003e","updated_at":"\u003cnumber\u003e"}],"statement_descriptor":"\u003cstring\u003e","type":"goods","unit_label":"\u003cstring\u003e","updated_at":"\u003cnumber\u003e"},"tiers":[{"amount":"\u003cnumber\u003e","flat_amount":"\u003cnumber\u003e","up_to":"\u003cstring\u003e"}],"tiers_mode":"volume","transform_usage":{"divide_by":"\u003cnumber\u003e","round":"\u003cstring\u003e"},"trial_period_days":"\u003cnumber\u003e","usage_type":"metered"},"quantity":"\u003cnumber\u003e","subscription_id":"\u003cstring\u003e"}],"has_more":"\u003cboolean\u003e","total_count":"\u003cnumber\u003e","url":"\u003cstring\u003e"},"tax_percent":"\u003cnumber\u003e","trial_end":"\u003cnumber\u003e","trial_start":"\u003cnumber\u003e","type":"payout"}]},"fingerprint":"\u003cstring\u003e","image":"\u003cstring\u003e","instructions":"\u003cstring\u003e","is_cancelable":"\u003cboolean\u003e","is_expirable":"\u003cboolean\u003e","is_online":"\u003cboolean\u003e","is_refundable":"\u003cboolean\u003e","is_required":"\u003cboolean\u003e","is_tokenizable":"\u003cboolean\u003e","is_virtual":"\u003cboolean\u003e","last4":"3150","maximum_expiration_seconds":"\u003cinteger\u003e","minimum_expiration_seconds":"\u003cinteger\u003e","multiple_overage_allowed":"\u003cboolean\u003e","name":"\u003cstring\u003e","payment_flow_type":"direct"},"status":"\u003cstring\u003e","risk_level":"not_assessed","seller_message":"\u003cstring\u003e"},"paid":false,"paid_at":0,"payment_fees":{"fx_fee":{"calc_type":"\u003cstring\u003e","value":"\u003cnumber\u003e"},"gross_fees":"\u003cnumber\u003e","net_fees":"\u003cnumber\u003e","transaction_fee":{"calc_type":"\u003cstring\u003e","fee_type":"\u003cstring\u003e","value":"\u003cnumber\u003e"}},"payment_method":"\u003cstring\u003e","payment_method_data":{},"payment_method_options":{},"payment_method_type":"\u003cstring\u003e","payment_method_type_category":"card","receipt_email":"\u003cstring\u003e","receipt_number":"\u003cstring\u003e","redirect_url":"\u003cstring\u003e","refunded":false,"refunded_amount":0,"refunds":{"data":["\u003cstring\u003e"],"has_more":"\u003cboolean\u003e","total_count":"\u003cinteger\u003e","url":"\u003cstring\u003e"},"remitter_information":{},"save_payment_method":"\u003cboolean\u003e","statement_descriptor":"\u003cstring\u003e","status":"ACT","textual_codes":{},"transaction_id":"\u003cstring\u003e","visual_codes":{}},"payout":{"amount":"\u003cnumber\u003e","beneficiary":{"aba":"\u003cstring\u003e","account_number":"\u003cstring\u003e","ach_code":"\u003cstring\u003e","additional_data":{},"additional_last_name":"\u003cstring\u003e","address":"\u003cstring\u003e","bank_account_holder_name":"\u003cstring\u003e","bank_account_type":"\u003cstring\u003e","bank_address":"\u003cstring\u003e","bank_branch_code":"\u003cstring\u003e","bank_branch_name":"\u003cstring\u003e","bank_city":"\u003cstring\u003e","bank_code":"\u003cstring\u003e","bank_country":"\u003cstring\u003e","bank_name":"\u003cstring\u003e","bank_province":"\u003cstring\u003e","beneficiary_bic_local":"\u003cstring\u003e","beneficiary_relationship":"\u003cstring\u003e","bic_swift":"\u003cstring\u003e","bsb_code":"\u003cstring\u003e","card_expiration_month":"\u003cstring\u003e","card_expiration_year":"\u003cstring\u003e","card_number":"\u003cstring\u003e","category":"bank_transfer","city":"\u003cstring\u003e","clabe":"\u003cstring\u003e","cnaps":"\u003cstring\u003e","company_name":"\u003cstring\u003e","confirmation_required":"\u003cboolean\u003e","country":"IL","currency":"XDR","date_of_birth":"\u003cstring\u003e","date_of_incorporation":"\u003cstring\u003e","default_payout_method_type":"\u003cstring\u003e","email":"\u003cstring\u003e","entity_type":"individual","ewallet":"\u003cstring\u003e","first_name":"\u003cstring\u003e","iban":"\u003cstring\u003e","id":"\u003cstring\u003e","id_date_of_issue":"\u003cstring\u003e","id_issue_authority":"\u003cstring\u003e","id_issue_location":"\u003cstring\u003e","identification_type":"\u003cstring\u003e","identification_value":"\u003cstring\u003e","ifsc":"\u003cstring\u003e","issuer_code":"\u003cstring\u003e","last_name":"\u003cstring\u003e","merchant_reference_id":"\u003cstring\u003e","middle_name":"\u003cstring\u003e","mobile_number":"\u003cstring\u003e","name":"\u003cstring\u003e","nationality":"\u003cstring\u003e","payment_type":"\u003cstring\u003e","phone_country_code":"\u003cstring\u003e","phone_number":"\u003cstring\u003e","postcode":"\u003cstring\u003e","province":"\u003cstring\u003e","purpose_code":"\u003cstring\u003e","routing_code_type_1":"\u003cstring\u003e","routing_code_type_2":"\u003cstring\u003e","routing_code_type_3":"\u003cstring\u003e","routing_code_value_1":"\u003cstring\u003e","routing_code_value_2":"\u003cstring\u003e","routing_code_value_3":"\u003cstring\u003e","sort_code":"\u003cstring\u003e","state":"\u003cstring\u003e","statement_narrative":"\u003cstring\u003e","suburb":"\u003cstring\u003e","tax_id":"\u003cstring\u003e","vpa":"\u003cstring\u003e"},"beneficiary_country":"VN","created_at":"\u003cinteger\u003e","description":"\u003cstring\u003e","error":"\u003cstring\u003e","estimated_time_of_arrival":"\u003cstring\u003e","ewallets":[{"amount":"\u003cnumber\u003e","ewallet_id":"\u003cstring\u003e","percent":"\u003cnumber\u003e"}],"expiration":"\u003cnumber\u003e","fx_rate":"\u003cnumber\u003e","gc_error_code":"\u003cstring\u003e","id":"\u003cstring\u003e","identifier_type":"\u003cstring\u003e","identifier_value":"\u003cstring\u003e","instructions":{},"instructions_value":{},"merchant_reference_id":"\u003cstring\u003e","metadata":{},"paid_amount":"\u003cnumber\u003e","paid_at":"\u003cstring\u003e","payout_currency":"BWP","payout_fees":{"fx_fee":{"calc_type":"\u003cstring\u003e","value":"\u003cnumber\u003e"},"gross_fees":"\u003cnumber\u003e","net_fees":"\u003cnumber\u003e","transaction_fee":{"calc_type":"\u003cstring\u003e","fee_type":"\u003cstring\u003e","value":"\u003cnumber\u003e"}},"payout_method_type":"\u003cstring\u003e","payout_type":"bank","sender":{"account_number":"\u003cstring\u003e","additional_data":{},"additional_last_name":"\u003cstring\u003e","address":"\u003cstring\u003e","bank_code":"\u003cstring\u003e","bank_name":"\u003cstring\u003e","beneficiary_relationship":"\u003cstring\u003e","city":"\u003cstring\u003e","company_name":"\u003cstring\u003e","country":"NR","currency":"IDR","date_of_birth":"\u003cstring\u003e","date_of_incorporation":"\u003cstring\u003e","email":"\u003cstring\u003e","entity_type":"company","first_name":"\u003cstring\u003e","id":"\u003cstring\u003e","id_date_of_issue":"\u003cstring\u003e","id_expiry":"\u003cstring\u003e","id_issue_authority":"\u003cstring\u003e","id_issue_location":"\u003cstring\u003e","identification_type":"\u003cstring\u003e","identification_value":"\u003cstring\u003e","last_name":"\u003cstring\u003e","merchant_reference_id":"\u003cstring\u003e","middle_name":"\u003cstring\u003e","mobile_number":"\u003cstring\u003e","name":"\u003cstring\u003e","nationality":"\u003cstring\u003e","occupation":"\u003cstring\u003e","phone_country_code":"\u003cstring\u003e","phone_number":"\u003cstring\u003e","postcode":"\u003cstring\u003e","province":"\u003cstring\u003e","purpose_code":"\u003cstring\u003e","source_of_income":"\u003cstring\u003e","state":"\u003cstring\u003e","suburb":"\u003cstring\u003e","tax_id":"\u003cstring\u003e"},"sender_amount":"\u003cnumber\u003e","sender_country":"QA","sender_currency":"HTG","statement_descriptor":"\u003cstring\u003e","status":"Returned"},"period_end":"\u003cnumber\u003e","period_start":"\u003cnumber\u003e","lines":[{"id":"\u003cstring\u003e","amount":"\u003cnumber\u003e","currency":"LAK","description":"\u003cstring\u003e","discountable":"\u003cboolean\u003e","invoice_item":"\u003cstring\u003e","metadata":{},"period":{"start":"\u003cstring\u003e","end":"\u003cstring\u003e"},"proration":"\u003cboolean\u003e","quantity":"\u003cnumber\u003e","plan":{"active":"\u003cboolean\u003e","aggregate_usage":"last_during_period","amount":"\u003cnumber\u003e","billing_scheme":"tiered","created_at":"\u003cnumber\u003e","currency":"BIF","id":"\u003cstring\u003e","interval":"week","interval_count":"\u003cnumber\u003e","metadata":{},"nickname":"\u003cstring\u003e","product":{"active":"\u003cboolean\u003e","attributes":["\u003cstring\u003e"],"created_at":"\u003cnumber\u003e","description":"\u003cstring\u003e","id":"\u003cstring\u003e","images":["\u003cstring\u003e"],"metadata":{},"name":"\u003cstring\u003e","package_dimensions":{"height":"\u003cnumber\u003e","length":"\u003cnumber\u003e","weight":"\u003cnumber\u003e","width":"\u003cnumber\u003e"},"shippable":"\u003cboolean\u003e","skus":[{"active":"\u003cboolean\u003e","attributes":{},"created_at":"\u003cnumber\u003e","currency":"CRC","id":"\u003cstring\u003e","image":"\u003cstring\u003e","inventory":{},"metadata":{},"package_dimensions":{"height":"\u003cnumber\u003e","length":"\u003cnumber\u003e","weight":"\u003cnumber\u003e","width":"\u003cnumber\u003e"},"price":"\u003cnumber\u003e","product":"\u003cstring\u003e","updated_at":"\u003cnumber\u003e"}],"statement_descriptor":"\u003cstring\u003e","type":"services","unit_label":"\u003cstring\u003e","updated_at":"\u003cnumber\u003e"},"tiers":[{"amount":"\u003cnumber\u003e","flat_amount":"\u003cnumber\u003e","up_to":"\u003cstring\u003e"}],"tiers_mode":"graduated","transform_usage":{"divide_by":"\u003cnumber\u003e","round":"\u003cstring\u003e"},"trial_period_days":"\u003cnumber\u003e","usage_type":"metered"},"subscription":"\u003cstring\u003e","subscription_item":"\u003cstring\u003e","type":"\u003cstring\u003e"}],"subtotal":"\u003cnumber\u003e","tax":"\u003cnumber\u003e","number":"\u003cstring\u003e","total":"\u003cnumber\u003e","status":"\u003cstring\u003e","payout_fields":{},"type":"payout"}],"status":{"error_code":"\u003cstring\u003e","message":"\u003cstring\u003e","operation_id":"\u003cstring\u003e","response_code":"\u003cstring\u003e","status":"\u003cstring\u003e"}}