List invoices

API to get list of invoices

GET https://services.leadconnectorhq.com/invoices/

Autorización

string

required

Bearer token generado desde el portal Leadway. Ver Autenticación.

string

default:"2021-07-28"

required

Versión de la API.

Query parameters

string

default:"6578278e879ad2646715ba9c"

required

account Id / company Id based on altType

string

default:"account"

required

Alt Type

string

status to be filtered

string

default:"2023-01-01"

startAt in YYYY-MM-DD format

string

default:"2023-01-01"

endAt in YYYY-MM-DD format

string

default:"Alex"

To search for an invoice by id / name / email / phoneNo

string

default:"live"

payment mode

string

default:"AmuzcoPBpgKeccNsFlib"

Contact ID for the invoice

string

default:"10"

required

Limit the number of items to return

string

default:"10"

required

Number of items to skip

string

default:"issueDate"

The field on which sorting should be applied

string

default:"descend"

The order of sort which should be applied for the sortField

Respuestas

200 - Successful response

object[]

required

Show cada item

string

default:"6578278e879ad2646715ba9c"

required

Invoice Id

string

default:"draft"

required

Invoice Status Posibles valores: ‘draft’, ‘sent’, ‘payment_processing’, ‘paid’, ‘void’, ‘partially_paid’

boolean

default:"False"

required

Live Mode

number

default:"0"

required

Amount Paid

string

default:"6578278e879ad2646715ba9c"

required

Account Id or Agency Id

string

required

Posibles valores: ‘account’

string

default:"New Invoice"

required

Name of the invoice

object

required

Business Details

number

default:"19"

required

Invoice Number

string

default:"USD"

required

Currency

object

required

Contact Details

string

default:"2023-01-01"

required

Issue date in YYYY-MM-DD format

string

default:"2023-01-01"

required

Due date in YYYY-MM-DD format

object

Discount

string[]

required

Invoice Items

number

default:"999"

required

Total Amount

string

default:"INVOICE"

required

Title

number

default:"999"

required

Total Amount Due

string

default:"2023-12-12T09:27:42.355Z"

required

created at

string

default:"2023-12-12T09:27:42.355Z"

required

updated at

boolean

default:"True"

Automatic taxes enabled for the Invoice

boolean

default:"True"

Is Automatic taxes calculated for the Invoice items

object

split invoice into payment schedule summing up to full invoice amount

object

required

Show propiedades

number

default:"999"

required

subTotal

number

default:"0"

required

discount

number

default:"0"

required

tax

object

Reminders Configuration

number

default:"100"

required

Total number of invoices

{
  "invoices": [
    {
      "_id": "6578278e879ad2646715ba9c",
      "status": "draft",
      "liveMode": false,
      "amountPaid": 0,
      "altId": "6578278e879ad2646715ba9c",
      "altType": "account",
      "name": "New Invoice",
      "businessDetails": {
        "name": "Alex",
        "address": {
          "addressLine1": "9931 Beechwood",
          "city": "St. Houston",
          "state": "TX",
          "countryCode": "USA",
          "postalCode": "559-6993"
        },
        "phoneNo": "+1-214-559-6993",
        "website": "www.example.com"
      },
      "invoiceNumber": "19",
      "currency": "USD",
      "contactDetails": {
        "id": "c6tZZU0rJBf30ZXx9Gli",
        "phoneNo": "+1-214-559-6993",
        "email": "alex@example.com",
        "customFields": [],
        "name": "Alex",
        "address": {
          "countryCode": "US"
        }
      },
      "issueDate": "2023-01-01",
      "dueDate": "2023-01-01",
      "discount": {
        "type": "percentage",
        "value": 0
  // truncado: 30 lineas mas
}

400 - Bad Request

{}

401 - Unauthorized

{}

422 - Unprocessable Entity

{}

Ejemplo

curl -X GET 'https://services.leadconnectorhq.com/invoices/' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28'

const response = await fetch('https://services.leadconnectorhq.com/invoices/', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.LEADWAY_TOKEN}`,
    Version: '2021-07-28',
  },
});
const data = await response.json();

import os, requests
response = requests.request(
    'GET',
    'https://services.leadconnectorhq.com/invoices/',
    headers={
        'Authorization': f"Bearer {os.environ['LEADWAY_TOKEN']}",
        'Version': '2021-07-28',
    },
)
data = response.json()

<?php
$ch = curl_init('https://services.leadconnectorhq.com/invoices/');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('LEADWAY_TOKEN'),
        'Version: 2021-07-28',
    ],
]);
$data = json_decode(curl_exec($ch), true);

Empezar

Scopes

Autorización

Query parameters

Respuestas

Ejemplo

​Autorización

​Query parameters

​Respuestas

​Ejemplo

Autorización

Query parameters

Respuestas

Ejemplo