---
updatedAt: 2025-11-11T00:09:37.000Z
agentTools:
  projectIndex: https://docs.interswitchgroup.com/llms.txt
---

# Get Invoices

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "invoice",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://qa.interswitchng.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {}
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/paymentgateway/api/v1/merchant/invoice/all/{merchantCode}": {
      "get": {
        "summary": "Get Invoices",
        "description": "",
        "operationId": "get-invoices",
        "parameters": [
          {
            "name": "merchantCode",
            "in": "path",
            "schema": {
              "type": "string",
              "default": "MX6072"
            },
            "required": true
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": "1"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": "100"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "Bearer eyJhbGciOiJSUzI1NiJ9.eyJhdWQiOlsicGFzc3BvcnQiLCJwcm9qZWN0LXgtbWVyY2hhbnQiXSwic2NvcGUiOlsicHJvZmlsZSJdLCJqdGkiOiI5MDFiZGEzYi0xYzYzLTQ4YWQtOTkyZS05YWYwMzI2OGJmNTEiLCJjbGllbnRfaWQiOiJJS0lBQzQ0MjBEMTNBQkU1N0Q3NzhGQjcyNjNBMTdEMTNCNjBBOEFFNDEzNSJ9.dyre2W3xYk5yW5YHgTWbEyNo6O0JHcYH7ya8yqwJq7rLo4EboMmKv7jmvA4FdziATRJmM4ttA9-otpMOX0Hz2_j8uX6azbv6gf1vN-CPM0qvgOtTdjegtvghJ-dWIpOfa4cyvj7evS2_zJo8pnplmS6ZuhZ74mwx1GQcH6CgkNCeTE0PN1aXM7_-1D6BOiHtTnxWJWh0nMroYpFzZl-ew6TtHPRJ3YNxTupmtpQIn8ORQKvK_LadZzs1jrxMH1P3RaSQ0AGqGSVhXm6uudQM8oWbIP3A-vSSH4tuys3_kOMrWP68aOM7OV_ArHb9hRHeZG1_hHDZQKvURJZelcBvkA"
            }
          },
          {
            "name": "Content-Type",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "application/json"
            }
          },
          {
            "name": "merchantCode",
            "in": "query",
            "description": "Merchant Code as obtained from your Quickteller Business Dashboard.",
            "required": true,
            "schema": {
              "type": "string",
              "default": "MX6072"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"count\": 63,\n    \"content\": [\n        {\n            \"id\": 30491,\n            \"amount\": 242000,\n            \"customerName\": \"Jeje\",\n            \"customerEmail\": \"bughunting005@gmail.com\",\n            \"description\": \"ggg\",\n            \"merchantCode\": \"MX6072\",\n            \"payableCode\": \"1007957\",\n            \"payableId\": 34374,\n            \"reference\": \"INVC2GITRA6Y\",\n            \"invoiceLink\": \"https://qa.interswitchng.com/paymentgateway/invoice/pay/INVC2GITRA6Y\",\n            \"lineItems\": [\n                {\n                    \"itemName\": \"tt\",\n                    \"quantity\": 20,\n                    \"itemAmount\": 8000\n                },\n                {\n                    \"itemName\": \"ff\",\n                    \"quantity\": 1,\n                    \"itemAmount\": 82000\n                }\n            ],\n            \"invoiceStatus\": \"LATE\",\n            \"responseCode\": null,\n            \"tax\": 10.0,\n            \"discountPercent\": 0.0,\n            \"address\": null,\n            \"shippingFee\": 10000,\n            \"dueDate\": 1626390000000,\n            \"createdDate\": 1626338756393,\n            \"lastUpdated\": 1627055765593,\n            \"currencyCode\": \"566\"\n        },\n        {\n            \"id\": 30490,\n            \"amount\": 108600,\n            \"customerName\": \"Test 2\",\n            \"customerEmail\": \"bughunting005@gmail.com\",\n            \"description\": \"\",\n            \"merchantCode\": \"MX6072\",\n            \"payableCode\": \"1007957\",\n            \"payableId\": 34374,\n            \"reference\": \"INVCQT7CYU1G\",\n            \"invoiceLink\": \"https://qa.interswitchng.com/paymentgateway/invoice/pay/INVCQT7CYU1G\",\n            \"lineItems\": [\n                {\n                    \"itemName\": \"Test\",\n                    \"quantity\": 2,\n                    \"itemAmount\": 54300\n                }\n            ],\n            \"invoiceStatus\": \"PAID\",\n            \"responseCode\": \"00\",\n            \"tax\": 0.0,\n            \"discountPercent\": 0.0,\n            \"address\": null,\n            \"shippingFee\": 0,\n            \"dueDate\": 1627167600000,\n            \"createdDate\": 1626177544250,\n            \"lastUpdated\": 1626211478920,\n            \"currencyCode\": \"566\"\n        }\n    ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "count": {
                      "type": "integer",
                      "example": 63,
                      "default": 0
                    },
                    "content": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "example": 30491,
                            "default": 0
                          },
                          "amount": {
                            "type": "integer",
                            "example": 242000,
                            "default": 0
                          },
                          "customerName": {
                            "type": "string",
                            "example": "Jeje"
                          },
                          "customerEmail": {
                            "type": "string",
                            "example": "bughunting005@gmail.com"
                          },
                          "description": {
                            "type": "string",
                            "example": "ggg"
                          },
                          "merchantCode": {
                            "type": "string",
                            "example": "MX6072"
                          },
                          "payableCode": {
                            "type": "string",
                            "example": "1007957"
                          },
                          "payableId": {
                            "type": "integer",
                            "example": 34374,
                            "default": 0
                          },
                          "reference": {
                            "type": "string",
                            "example": "INVC2GITRA6Y"
                          },
                          "invoiceLink": {
                            "type": "string",
                            "example": "https://qa.interswitchng.com/paymentgateway/invoice/pay/INVC2GITRA6Y"
                          },
                          "lineItems": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "itemName": {
                                  "type": "string",
                                  "example": "tt"
                                },
                                "quantity": {
                                  "type": "integer",
                                  "example": 20,
                                  "default": 0
                                },
                                "itemAmount": {
                                  "type": "integer",
                                  "example": 8000,
                                  "default": 0
                                }
                              }
                            }
                          },
                          "invoiceStatus": {
                            "type": "string",
                            "example": "LATE"
                          },
                          "responseCode": {},
                          "tax": {
                            "type": "integer",
                            "example": 10,
                            "default": 0
                          },
                          "discountPercent": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "address": {},
                          "shippingFee": {
                            "type": "integer",
                            "example": 10000,
                            "default": 0
                          },
                          "dueDate": {
                            "type": "integer",
                            "example": 1626390000000,
                            "default": 0
                          },
                          "createdDate": {
                            "type": "integer",
                            "example": 1626338756393,
                            "default": 0
                          },
                          "lastUpdated": {
                            "type": "integer",
                            "example": 1627055765593,
                            "default": 0
                          },
                          "currencyCode": {
                            "type": "string",
                            "example": "566"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": []
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```