---
title: "Post a bill payment"
method: POST
path: "/companies/{companyId}/bill-payments"
tags: ["Partner API"]
---

# Post a bill payment

`POST /companies/{companyId}/bill-payments`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/companies/{companyId}/bill-payments`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

## Path parameters

- `companyId` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- BillPaymentPostRequest
  - `vendorContactId` string, uuid, required
  - `payFromAccountId` string, uuid, required
  - `date` string, date, required
  - `amountCents` integer, required: Integer cents. Example: 1250 means $12.50.
  - `paymentType` 'cash' | 'check' | 'credit_card' | 'bank_transfer' | 'other'
  - `reference` string, nullable
  - `notes` string, nullable
  - `currencyCode` string
  - `metadata` object
  - `lines` object[], required
    - `billId` string, uuid, required
    - `amountCents` integer, required: Integer cents. Example: 1250 means $12.50.

## Response `200`

Idempotent replay

- PostingResponse
  - `data` PostingReceipt
    - `id` string, uuid, required
    - `resourceType` 'purchase' | 'deposit' | 'transfer' | 'bill_payment' | 'journal_entry', required
    - `status` 'draft' | 'posted', required
    - `journalEntryId` string, uuid, required
    - `bankTransactionIds` string[], required
    - `paymentId` string, uuid
    - `ruleResults` PostedTransactionRuleResult[]
      - `bankTransactionId` string, uuid, required
      - `status` 'created' | 'updated' | 'existing' | 'skipped' | 'failed', required
      - `created` boolean, required
      - `ruleId` string, uuid
      - `reason` string
      - `message` string
    - `affectedAccountIds` string[], required
    - `idempotentReplay` boolean, required
    - `createdAt` string, date-time, required

## Other responses

- `201`: Posting created
- `409`: Idempotency conflict
- `default`: Structured posting error

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)