Get Bill

GET

/bills/:id

GET

/v1/bills/:id

curl https://api.papertracc.com/v1/bills/id \
     -H "Authorization: Bearer <apiKey>"

{
  "data": {
    "id": "45c6e26d-e132-4548-8e2e-5bfc467cf94a",
    "items": [
      {
        "rate": "50000.00",
        "amount": "500000.00",
        "detail": "Consulting hours",
        "tax_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1",
        "quantity": 10,
        "account_id": "d037d299-3029-4dc7-8e72-172f80f23c4f",
        "inventory_id": "55a40b4d-a23a-49aa-a417-828913e9a5c8",
        "currency_code": "NGN",
        "sku": "SKU-1001"
      }
    ],
    "amount": "250000.00",
    "status": "PENDING",
    "vendor": {
      "id": "0cb2d1a5-2f50-43a1-8c3f-df06f998ef51",
      "display_name": "Global Softworks"
    },
    "approval": 0,
    "due_date": "2026-07-18T10:00:00Z",
    "approvals": [],
    "bill_date": "2026-06-18T10:00:00Z",
    "documents": [],
    "account_id": "d037d299-3029-4dc7-8e72-172f80f23c4f",
    "created_at": "2026-06-18T10:00:00Z",
    "project_id": "spruce-demo",
    "adjustments": [
      {
        "name": "VAT",
        "type": "PERCENTAGE_RATE",
        "value": "7.50",
        "amount": "37500.00",
        "operation": "ADDITION",
        "account_id": "2b0d1461-e52e-4a1a-a69c-11801431c2c9"
      }
    ],
    "payment_schedule": {
      "term_id": "c81e7a35-2f4d-4b6c-9a0e-5d3b7f1c8e92",
      "name": "60/40 split",
      "net_days": 30,
      "instalments": [
        {
          "type": "PERCENTAGE_RATE",
          "value": "60",
          "net_days": 15,
          "due_date": "2026-07-03T10:00:00Z",
          "amount": "150000.00"
        },
        {
          "type": "PERCENTAGE_RATE",
          "value": "40",
          "net_days": 30,
          "due_date": "2026-07-18T10:00:00Z",
          "amount": "100000.00"
        }
      ],
      "discount": null
    },
    "prepared_by": "user-token-hash",
    "currency_code": "NGN",
    "exchange_rate": "1.00",
    "bill_reference": "BILL-0001",
    "journal_status": "UNPOSTED"
  },
  "status": true,
  "message": "Successfully fetched bill"
}

Fetches one bill.

Requires the can_view_bill permission on the key owner’s role.

Keys: secret key only.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

identitystring

The identity for the active workspace.

Path parameters

idstringRequired

Response

dataobject

statusboolean

messagestring

Errors

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error