Expenses

Create and manage expenses.

  • GET /expense/all List Expense(s)
  • GET /expense/{id} Get Expense
  • POST /expense/add Add Expense
  • PUT /expense/{id} Edit / Update Expense
  • DELETE /expense/{id} Delete Expense

List Expense(s)

HTTP Request

GET https://api.invoice.ng/v1/expense/all

Response HTTP/1.1 200 OK
{
    "status": "success",
    "data": [
        {
            "id": "994230036710411",
            "short_code": "FLOKGC9DI3",
            "category": "General Expenses",
            "description": "Monthly Internet Subscription",
            "amount": "2500",
            "currency": "NGN",
            "vendor": "Swift Nigeria",
            "issued_date": "2018-02-19",
            "created_at": "2018-02-21 05:30:31",
            "updated_at": "2018-02-21 05:30:31"
        },
        ...
    ]
}

Get Expense

HTTP Request

GET https://api.invoice.ng/v1/expense/{id}

Response HTTP/1.1 200 OK
{
    "status": "success",
    "expense": [
        {
            "id": "994230036710411",
            "short_code": "FLOKGC9DI3",
            "category": "General Expenses",
            "description": "Monthly Internet Subscription",
            "amount": "2500",
            "currency": "NGN",
            "vendor": "Swift Nigeria",
            "issued_date": "2018-02-19",
            "created_at": "2018-02-21 05:30:31",
            "updated_at": "2018-02-21 05:30:31"
        }
    ]
}

Add / Create Expense

HTTP Request

POST https://api.invoice.ng/v1/expense/add

Query Parameters
Parameter Type Description
description string Expense name or description (required)
issue_date date Date the expense was issued ( YYYY-MM-DD ) (required)
amount numeric Amount (required)
currency string ISO 4217 currency code e.g. USD, GBP, EUR, NGN etc. (required)
vendor string Name of the vendor or supplier (optional)
Response HTTP/1.1 200 OK
{
    "status": "success",
    "expense": [
        {
            "id": "909632780692043",
            "short_code": "6Y4Q6OFGCR",
            "category": "General Expenses",
            "description": "Aprils Monthly Internet Subscription",
            "amount": "2500",
            "currency": "NGN",
            "vendor": "Swift Nigeria",
            "issued_date": "2018-04-03",
            "created_at": "2018-04-03 16:42:08",
            "updated_at": "2018-04-03 16:42:08"
        }
    ]
}

Edit / Update Expense

HTTP Request

PUT https://api.invoice.ng/v1/expense/{id}

Query Parameters
Parameter Type Description
description string Expense name or description (required)
issue_date date Date the expense was issued ( YYYY-MM-DD ) (required)
amount numeric Amount (required)
currency string ISO 4217 currency code e.g. USD, GBP, EUR, NGN etc. (required)
vendor string Name of the vendor or supplier (optional)
Response HTTP/1.1 200 OK
{
    "status": "success",
    "expense": [
        {
            "id": "909632780692043",
            "short_code": "6Y4Q6OFGCR",
            "category": "General Expenses",
            "description": "Aprils Monthly Internet Subscription",
            "amount": "2500",
            "currency": "NGN",
            "vendor": "Swift Nigeria",
            "issued_date": "2018-04-03",
            "created_at": "2018-04-03 16:42:08",
            "updated_at": "2018-04-03 16:42:08"
        }
    ]
}

Delete Expense

HTTP Request

DELETE https://api.invoice.ng/v1/expense/{id}

Response HTTP/1.1 200 OK
{
    "status": "success",
    "id": "909632780692043"
}

© 2024 InvoiceApp Inc. All Rights Reserved.