---
agentTools:
  projectIndex: https://ledgers.readme.io/llms.txt
---

# Add Receipt

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Production with User Token",
    "version": "3-India"
  },
  "servers": [
    {
      "url": "https://in-api.ledgers.cloud/v3"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header"
      },
      "sec1": {
        "type": "apiKey",
        "name": "api-token",
        "in": "header"
      }
    }
  },
  "security": [
    {
      "sec0": [],
      "sec1": []
    }
  ],
  "paths": {
    "/receipt": {
      "post": {
        "summary": "Add Receipt",
        "description": "",
        "operationId": "add-receipt",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "seller_info": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "integer",
                        "description": "The unique identifier for the seller.",
                        "format": "int64"
                      },
                      "name": {
                        "type": "string",
                        "description": "The name of the seller or business."
                      },
                      "email": {
                        "type": "string",
                        "description": "The email address of the seller."
                      },
                      "phone": {
                        "type": "string",
                        "description": "The phone number of the seller."
                      },
                      "gstin": {
                        "type": "string",
                        "description": "Goods and Services Tax Identification Number (GSTIN) of the seller."
                      },
                      "address": {
                        "type": "object",
                        "description": "The physical address of the seller.",
                        "properties": {
                          "address1": {
                            "type": "string",
                            "description": "First line of the address."
                          },
                          "address2": {
                            "type": "string",
                            "description": "Second line of the address."
                          },
                          "city": {
                            "type": "string",
                            "description": "The city where the seller is located."
                          },
                          "state": {
                            "type": "string",
                            "description": "The state where the seller is located."
                          },
                          "pincode": {
                            "type": "string",
                            "description": "The postal code of the seller’s address."
                          },
                          "country": {
                            "type": "string",
                            "description": "The country of the seller."
                          }
                        }
                      }
                    }
                  },
                  "contact": {
                    "type": "object",
                    "required": [
                      "id",
                      "name"
                    ],
                    "properties": {
                      "id": {
                        "type": "integer",
                        "description": "The unique identifier for the contact.",
                        "format": "int32"
                      },
                      "name": {
                        "type": "string",
                        "description": "The name of the contact."
                      },
                      "business_name": {
                        "type": "string",
                        "description": "he business name of the contact."
                      },
                      "email": {
                        "type": "string",
                        "description": "The email address of the contact."
                      },
                      "mobile": {
                        "type": "string",
                        "description": "The mobile phone number of the contact."
                      },
                      "business_country": {
                        "type": "string",
                        "description": "The country where the contact’s business is based"
                      },
                      "country_code": {
                        "type": "string",
                        "description": "The country code for the contact’s phone number."
                      },
                      "place_of_supply": {
                        "type": "string"
                      }
                    }
                  },
                  "billing_address": {
                    "type": "object",
                    "properties": {
                      "bill_addr1": {
                        "type": "string",
                        "description": "First line of the billing address."
                      },
                      "bill_addr2": {
                        "type": "string",
                        "description": "Second line of the billing address."
                      },
                      "bill_gstin": {
                        "type": "string",
                        "description": "GSTIN for billing"
                      },
                      "bill_city": {
                        "type": "string",
                        "description": "City for billing."
                      },
                      "bill_state": {
                        "type": "string",
                        "description": "State for billing"
                      },
                      "bill_country": {
                        "type": "string",
                        "description": "Country for billing"
                      },
                      "bill_pincode": {
                        "type": "string",
                        "description": "Postal code for billing"
                      }
                    }
                  },
                  "shipping_address": {
                    "type": "object",
                    "properties": {
                      "ship_addr1": {
                        "type": "string",
                        "description": "First line of the shipping address."
                      },
                      "ship_addr2": {
                        "type": "string",
                        "description": "Second line of the shipping address."
                      },
                      "ship_gstin": {
                        "type": "string",
                        "description": "GSTIN for shipping."
                      },
                      "ship_city": {
                        "type": "string",
                        "description": "City for shipping."
                      },
                      "ship_state": {
                        "type": "string",
                        "description": "State for shipping."
                      },
                      "ship_country": {
                        "type": "string",
                        "description": "Country for shipping."
                      },
                      "ship_pincode": {
                        "type": "string",
                        "description": "Postal code for shipping."
                      }
                    }
                  },
                  "currency": {
                    "type": "string"
                  },
                  "receipt_number": {
                    "type": "string"
                  },
                  "receipt_date": {
                    "type": "string"
                  },
                  "amount": {
                    "type": "string"
                  },
                  "payment_method": {
                    "type": "string"
                  },
                  "coa_id": {
                    "type": "string"
                  },
                  "notes": {
                    "type": "string"
                  },
                  "bank_branch": {
                    "type": "string"
                  },
                  "notification": {
                    "type": "string"
                  },
                  "branch_id": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"status\": 200,\n    \"data\": {\n        \"receipt_id\": {\n            \"id\": 3336\n        },\n        \"url\": \"https://ledgr.in/LEDGRS/N0GUrbaUhC54\",\n        \"pdf_link\": \"https://in.ledgers.cloud/public/print-receipt/S0J2cVV2Um9zRHp2UHpBUG9TTDZFdz09/aElQRjJTMTl1OEpuWUtxaEp5SU1uQT09?download=1\"\n    }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "integer",
                      "example": 200,
                      "default": 0
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "receipt_id": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "integer",
                              "example": 3336,
                              "default": 0
                            }
                          }
                        },
                        "url": {
                          "type": "string",
                          "example": "https://ledgr.in/LEDGRS/N0GUrbaUhC54"
                        },
                        "pdf_link": {
                          "type": "string",
                          "example": "https://in.ledgers.cloud/public/print-receipt/S0J2cVV2Um9zRHp2UHpBUG9TTDZFdz09/aElQRjJTMTl1OEpuWUtxaEp5SU1uQT09?download=1"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "The request was unacceptable, often due to missing a required parameter."
                  }
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"errorCode\": \"E0401\",\n    \"errorMessage\": \"x-API-key or API-token authentication failed. Contact LEDGERS Developer Support.\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "errorCode": {
                      "type": "string",
                      "example": "E0401"
                    },
                    "errorMessage": {
                      "type": "string",
                      "example": "x-API-key or API-token authentication failed. Contact LEDGERS Developer Support."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "403",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"errorCode\": \"E0403\",\n    \"errorMessage\": \"The API key doesn't have permission to perform the request. Contact LEDGERS Developer Support\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "errorCode": {
                      "type": "string",
                      "example": "E0403"
                    },
                    "errorMessage": {
                      "type": "string",
                      "example": "The API key doesn't have permission to perform the request. Contact LEDGERS Developer Support"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "500",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "Something went wrong on Ledgers end."
                  }
                }
              }
            }
          },
          "501": {
            "description": "501",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "Something went wrong on Ledgers end.50"
                  }
                }
              }
            }
          },
          "502": {
            "description": "502",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "Something went wrong on Ledgers end."
                  }
                }
              }
            }
          },
          "503": {
            "description": "503",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "Server cannot handle the request."
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "_id": "673ef64e825a22001fb16a5f:68062dbd271bad373370b551"
}
```