Pazy Documentation

Invoice Creation API

curl --request POST \
  --url https://api.pazy.io/v1.0/invoice

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.pazy.io/v1.0/invoice",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pazy.io/v1.0/invoice"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.pazy.io/v1.0/invoice")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

Invoice Creation API

curl --request POST \
  --url https://api.pazy.io/v1.0/invoice

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.pazy.io/v1.0/invoice",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pazy.io/v1.0/invoice"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.pazy.io/v1.0/invoice")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

Authentication

All requests require an API key in the request headers. Headers:

Authorization: Api-Key YOUR_API_KEY

Request

Content-Type: multipart/form-data

Body Parameters

Parameter	Type	Required	Description
`file`	File	Yes	The invoice file to upload. Supported formats: PDF, JPEG, JPG, PNG
`remarks`	String or Object	No	Optional remarks/notes for the invoice. Can be provided as a string value directly, or as an object with a `value` property containing the remarks string

File Requirements

Maximum file size: 50 MB
Supported formats: PDF (application/pdf), JPEG (image/jpeg), JPG (image/jpg), PNG (image/png)
The file should contain a readable invoice document

Code Examples

curl -X POST https://api.pazy.io/v1.0/invoice \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -F "file=@/path/to/invoice.pdf" \
  -F "remarks=Payment due in 30 days"

const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('remarks', 'Payment due in 30 days'); // Optional

const response = await fetch('https://api.pazy.io/v1.0/invoice', {
  method: 'POST',
  headers: {
    'Authorization': 'Api-Key YOUR_API_KEY'
  },
  body: formData
});

const result = await response.json();

import requests

url = "https://api.pazy.io/v1.0/invoice"
headers = {
    "Authorization": "Api-Key YOUR_API_KEY"
}

files = {
    'file': ('invoice.pdf', open('/path/to/invoice.pdf', 'rb'), 'application/pdf')
}

data = {
    'remarks': 'Payment due in 30 days'  # Optional
}

response = requests.post(url, headers=headers, files=files, data=data)
result = response.json()

Success Response

HTTP Status: 200 OK Response Fields:

Field	Type	Description
`ok`	boolean	Indicates whether the request was successful
`data`	object	Contains the invoice creation response data
`data.id`	string	Unique identifier for the invoice. Use this ID to retrieve invoice details later
`data.status`	string	Current processing status. Possible values: `PROCESSING`, `QUEUED`
`data.processingId`	string	Identifier for the processing job. Used for tracking invoice processing status
`data.isReady`	boolean	Indicates whether the invoice is ready for use. Initially `false` as the invoice is being processed

Response Example

{
  "ok": true,
  "data": {
    "id": "invoice_identifier",
    "status": "PROCESSING",
    "processingId": "job_123456",
    "isReady": false
  }
}

Status Values

PROCESSING: The invoice is currently being processed and parsed
QUEUED: The invoice has been queued for processing

After successful upload, the invoice will be processed asynchronously. Use the returned id to check the invoice status and retrieve details once processing is complete.

Error Responses

Missing File

HTTP Status: 400 Bad Request

{
  "ok": false,
  "error": {
    "code": "MISSING_REQUIRED_FIELD",
    "message": "File is required"
  }
}

Invalid File Type

HTTP Status: 400 Bad Request

{
  "ok": false,
  "error": {
    "code": "INVALID_FILE_TYPE",
    "message": "Invalid file type. Only PDF, JPEG, JPG, and PNG files are allowed"
  }
}

File Too Large

HTTP Status: 413 Payload Too Large (or 400 Bad Request)

{
  "ok": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Validation failed: fileSize: File size exceeds maximum allowed size"
  }
}

Authentication Errors

HTTP Status: 401 Unauthorized

{
  "ok": false,
  "error": {
    "code": "MISSING_CREDENTIALS",
    "message": "Missing Credentials"
  }
}

{
  "ok": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API Key"
  }
}

Permission Errors

HTTP Status: 403 Forbidden

{
  "ok": false,
  "error": {
    "code": "INSUFFICIENT_PERMISSIONS",
    "message": "Permission check failed - PERMISSION_CHECK_FAILED"
  }
}

Processing Errors

HTTP Status: 500 Internal Server Error

{
  "ok": false,
  "error": {
    "code": "INVOICE_CREATION_FAILED",
    "message": "Failed to create invoice"
  }
}

Vendor APIs

Purchase Order APIs

Invoice APIs

Expense APIs

Payment APIs

Reimbursement APIs

User APIs

Tags APIs

GRN APIs

Inventory APIs

Download APIs

Company APIs

Tax APIs

Invoice Creation API

Authentication

Request

Body Parameters

File Requirements

Code Examples

Success Response

Response Example

Status Values

Error Responses

Missing File

Invalid File Type

File Too Large

Authentication Errors

Permission Errors

Processing Errors

Best Practices

File Uploads

Invoice Processing

​Authentication

​Request

​Body Parameters

​File Requirements

​Code Examples

​Success Response

​Response Example

​Status Values

​Error Responses

​Missing File

​Invalid File Type

​File Too Large

​Authentication Errors

​Permission Errors

​Processing Errors

​Best Practices

​File Uploads

​Invoice Processing

Authentication

Request

Body Parameters

File Requirements

Code Examples

Success Response

Response Example

Status Values

Error Responses

Missing File

Invalid File Type

File Too Large

Authentication Errors

Permission Errors

Processing Errors

Best Practices

File Uploads

Invoice Processing