Create invoice item

Staging Env

https://api.stg.bidancer.com

POST

/billing-service/v1/admin/invoice/{invoiceId}/items/add

Last modified:2026-01-13 17:40:55

Add a new item to an invoice.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/x-www-form-urlencoded

Responses

🟢201Created

application/json

Success response for creating or updating a

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429429

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.stg.bidancer.com/billing-service/v1/admin/invoice//items/add' \
--header 'Authorization: Bearer <token>' \
--data-urlencode 'description=' \
--data-urlencode 'amount=' \
--data-urlencode 'currency=' \
--data-urlencode 'quantity=' \
--data-urlencode 'unitPrice=' \
--data-urlencode 'unit=' \
--data-urlencode 'unitTax=' \
--data-urlencode 'unitTaxAmount=' \
--data-urlencode 'taxType=' \
--data-urlencode 'taxIgstRate=' \
--data-urlencode 'taxCgstRate=' \
--data-urlencode 'taxSgstRate=' \
--data-urlencode 'taxIgstAmount=' \
--data-urlencode 'taxCgstAmount=' \
--data-urlencode 'taxSgstAmount=' \
--data-urlencode 'taxAmount=' \
--data-urlencode 'totalAmount='

Response Example

201 - Example 1

{
    "status": "success",
    "message": "string",
    "data": {
        "id": "string",
        "invoiceId": "string",
        "description": "string",
        "amount": 0,
        "currency": "string",
        "quantity": 0,
        "hsnCode": "string",
        "sacCode": "string",
        "unitPrice": 0,
        "unit": "string",
        "unitTax": 0,
        "unitTaxAmount": 0,
        "taxType": "overseas",
        "taxIgstRate": 0,
        "taxCgstRate": 0,
        "taxSgstRate": 0,
        "taxIgstAmount": 0,
        "taxCgstAmount": 0,
        "taxSgstAmount": 0,
        "taxAmount": 0,
        "totalAmount": 0,
        "createdAt": "2019-08-24T14:15:22.123Z",
        "updatedAt": "2019-08-24T14:15:22.123Z"
    }
}

Modified at 2026-01-13 17:40:55

Update billing account status

Update invoice item