API Reference

Your First API call: Create Invoice

Make your first API call in Paper.id

To test if your account is set up well and the credentials work, let us try to create our first sales invoices document.


(1) Assume that we are using Postman Client for testing, set your environment variable like

Environment VariableValue
BASE_URLhttps://open-api.stag-v2.paper.id
CLIENT_ID<Your Client ID>
CLIENT_SECRET<Your Client Secret>

(2) Create Your first Invoice by using Paper.id Open API by copy and paste this CURL command to your postman address bar

curl --location '{{BASE_URL}}/api/v1/store-invoice' \
--header 'client_id: {{CLIENT_ID}}' \
--header 'client_secret: {{CLIENT_SECRET}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "invoice_date": "16-06-2025",
    "due_date": "23-06-2025",
    "number": "INV/2025/06/00001",
    "customer": {
        "id": "mitra-testing-001",
        "name": "Mitra Test Staging 001",
        "email": "[email protected]", 
        "phone": "6281888888",
    },
    "items": [
        {
            "name": "Tools Maintenance Service",
            "description": "3H 3M",
            "quantity": 1,
            "price": 3000000,
            "discount": 0,
            "tax_id": "",
            "additional_info":{}
        }
    ],
    "signature_text_header": "Mei 28, 2025",
    "signature_text_footer": "Finance Team",
    "terms_condition": "We receive payment no later than 7 days after the bill is received",
    "notes": "Invoice include service fee",
    "send": {
        "email": false,
        "whatsapp": false,
        "sms": false
    },
    "additional_info" :{}
}'

(3) Send the Request, If you are successful, then you will get response similar to the result below

{
    "status_code": 201,
    "data": {
        "id": "3fef1947-36e1-454a-a020-0d35c5186ebb",
        "number": "INV/2025/06/INV02",
        "payper_url": "stg-v2.paper.id/frTCP8B",
        "pdf_url": "https://storage.googleapis.com/ppr-stg/export/47a07aa8-711e-4913-86cf-e54d1afcfee5/sales-invoice/pdf/INV_SAL_INV_2025_06_INV02.pdf",
        "pdf_url_short": "stg-v2.paper.id/HX5w7Z8",
        "status_send": {
            "email": false,
            "whatsapp": false,
            "sms": false
        }
    }
}