Skip to content

API v1.0.0 API

by envoice.in

API keyHTTPSFinance
Open documentation ↗

Overview

[![Run in Postman](https://run.pstmn.io/button.svg)](https://app.getpostman.com/run-collection/80638214aa04722c9203) <span style='margin-left: 0.5em;'>or</span> <a href='https://documenter.getpostman.com/view/3559821/TVeqcn2L' class='openapi-button' _ngcontent-c6>View Postman docs</a> # Quickstart Visit [github](https://github.com/EmitKnowledge/Envoice) to view the quickstart tutorial. <div class='postman-tutorial'> # Tutorial for running the API in postman Click on ""Run in Postman"" button <br /><br /> ![postman - tutorial - 1](/Assets/images/api/postman-tutorial/postman-tutorial-1.png) --- A new page will open. Click the ""Postman for windows"" to run postman as a desktop app. Make sure you have already [installed](https://www.getpostman.com/docs/postman/launching_postman/installation_and_updates) Postman. <br /><br /> ![postman - tutorial - 2](/Assets/images/api/postman-tutorial/postman-tutorial-2.png) --- In chrome an alert might show up to set a default app for opening postman links. Click on ""Open Postman"". <br /><br /> ![postman - tutorial - 3](/Assets/images/api/postman-tutorial/postman-tutorial-3.png) --- The OpenAPI specification will be imported in Postman as a new collection named ""Envoice api"" <br /><br /> ![postman - tutorial - 4](/Assets/images/api/postman-tutorial/postman-tutorial-4.png) --- When testing be sure to check and modify the environment variables to suit your api key and secret. The domain is set to envoice's endpoint so you don't really need to change that. <sub>\*Eye button in top right corner </sub> <br /><br /> ![postman - tutorial - 5](/Assets/images/api/postman-tutorial/postman-tutorial-5.png) <br /><br /> ![postman - tutorial - 6](/Assets/images/api/postman-tutorial/postman-tutorial-6.png) --- You don't need to change the values of the header parameters, because they will be replaced automatically when you send a request with real values from the environment configured in the previous step. <br /><br /> ![postman - tutorial - 7](/Assets/images/api/postman-tutorial/postman-tutorial-7.png) --- Modify the example data to suit your needs and send a request. <br /><br /> ![postman - tutorial - 8](/Assets/images/api/postman-tutorial/postman-tutorial-8.png) </div> # Webhooks Webhooks allow you to build or set up Envoice Apps which subscribe to invoice activities. When one of those events is triggered, we'll send a HTTP POST payload to the webhook's configured URL. Webhooks can be used to update an external invoice data storage. In order to use webhooks visit [this link](/account/settings#api-tab) and add upto 10 webhook urls that will return status `200` in order to signal that the webhook is working. All nonworking webhooks will be ignored after a certain period of time and several retry attempts. If after several attempts the webhook starts to work, we will send you all activities, both past and present, in chronological order. The payload of the webhook is in format: ``` { Signature: ""sha256 string"", Timestamp: ""YYYY-MM-DDTHH:mm:ss.FFFFFFFZ"", Activity: { Message: "string", Link: "share url", Type: int, InvoiceNumber: "string", InvoiceId: int, OrderNumber: "string", OrderId: int, Id: int, CreatedOn: "YYYY-MM-DDTHH:mm:ss.FFFFFFFZ" } } ```

API v1.0.0 is a finance API from envoice.in. Requests are authenticated with an API key. It is served over HTTPS. Its OpenAPI description documents 61 endpoints.

At a glance

Authentication
API key
HTTPS
Yes
CORS
Unknown
Category
Finance
Base URL
https://www.envoice.in
Version
v1
Endpoints
61
Spec updated
2023-03-06

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://www.envoice.in/api/client/all" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"
JavaScript
const response = await fetch("https://www.envoice.in/api/client/all", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://www.envoice.in/api/client/all",
    headers={
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
GET/api/client/allReturn all clients for the account
GET/api/client/candeleteCheck if the provided client can be deleted
POST/api/client/deleteDelete an existing client
GET/api/client/detailsReturn client details. Activities and invoices included.
POST/api/client/newCreate a client
POST/api/client/updateUpdate an existing client
GET/api/estimation/allReturn all estimation for the account
POST/api/estimation/changestatusChange estimation status
POST/api/estimation/convertConvert the estimation to an invoice
POST/api/estimation/deleteDelete an existing estimation
GET/api/estimation/detailsReturn estimation data
POST/api/estimation/newCreate an estimation
POST/api/estimation/sendtoclientSend the provided estimation to the client
GET/api/estimation/statusRetrieve the status of the estimation
POST/api/estimation/updateUpdate an existing estimation
GET/api/estimation/uriReturn the unique url to the client's invoice
GET/api/general/countriesReturn all of the platform supported countries
GET/api/general/currenciesReturn all of the platform supported currencies
GET/api/general/dateformatsReturn all of the platform supported Date Formats
GET/api/general/uilanguagesReturn all of the platform supported UI languages
GET/api/invoice/allReturn all invoices for the account
GET/api/invoice/allcategoriesReturn all invoice categories for the account
POST/api/invoice/changestatusChange invoice status
POST/api/invoice/deleteDelete an existing invoice
POST/api/invoice/deletecategoryDelete an existing invoice category
GET/api/invoice/detailsReturn invoice data
POST/api/invoice/newCreate an invoice
POST/api/invoice/newcategoryCreate an invoice category
GET/api/invoice/pdfReturn the PDF for the invoice
POST/api/invoice/sendtoaccountantSend the provided invoice to the accountant
POST/api/invoice/sendtoclientSend the provided invoice to the client
GET/api/invoice/statusRetrieve the status of the invoice
POST/api/invoice/updateUpdate an existing invoice
POST/api/invoice/updatecategoryUpdate an existing invoice category
GET/api/invoice/uriReturn the unique url to the client's invoice
GET/api/order/allReturn all orders for the account
POST/api/order/changeshippingdetailsChange order shipping details
POST/api/order/changestatusChange order status
POST/api/order/deleteDelete an existing order
GET/api/order/detailsReturn order details
POST/api/order/newCreate an order
GET/api/payment/supportedReturn all supported payment gateways (no currencies means all are supported)
GET/api/paymentlink/allCreate a payment link
POST/api/paymentlink/deleteDelete an existing payment link
POST/api/paymentlink/newCreate a payment link
GET/api/paymentlink/uriReturn the unique url to the client's payment link
GET/api/product/allReturn all products for the account
POST/api/product/deleteDelete an existing product
GET/api/product/detailsReturn product details
POST/api/product/newCreate a product
POST/api/product/updateUpdate an existing product
GET/api/tax/allReturn all taxes for the account
POST/api/tax/deleteDelete an existing tax
POST/api/tax/newCreate a tax
POST/api/tax/updateUpdate an existing tax
GET/api/worktype/allReturn all work types for the account
POST/api/worktype/deleteDelete an existing work type
GET/api/worktype/detailsReturn work type details
POST/api/worktype/newCreate a work type
GET/api/worktype/searchReturn all work types for the account that match the query param
POST/api/worktype/updateUpdate an existing work type

Questions

Does the API v1.0.0 API need an API key?

Yes. The API v1.0.0 API uses API key authentication; the documentation explains how to get credentials.

Does the API v1.0.0 API support HTTPS?

Yes, the API v1.0.0 API is served over HTTPS.

How many endpoints does the API v1.0.0 API have?

Its OpenAPI description lists 61 endpoints in version v1. All of them are shown on this page.

What are alternatives to the API v1.0.0 API?

Other Finance APIs include Stripe, SEC EDGAR Data, Plaid, Fed Treasury, Razorpay IFSC.

Compare alternatives →

Listed from APIs.guru (CC0).