# Payment Reference field in the Bills API

**URL:** <https://api-discuss.freeagent.com/t/payment-reference-field-in-the-bills-api/7233>\
**Category:** Uncategorized\
**Created:** [16 November 2026 10:11 UTC](https://api-discuss.freeagent.com/t/payment-reference-field-in-the-bills-api/7233 "2026-11-16T10:11:56Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![mike](https://api-discuss.freeagent.com/letter_avatar_proxy/v4/letter/m/58f4c7/32.png) [@mike](https://api-discuss.freeagent.com/u/mike)\
**Post date:** [16 November 2026 10:11 UTC](https://api-discuss.freeagent.com/t/payment-reference-field-in-the-bills-api/7233/1 "2026-11-16T10:11:56Z")

</div>

Hi everyone,

We’re integrating our purchasing system with FreeAgent and would like to set the Payment Reference (optional) field on a bill to the supplier’s invoice number.

We can see and edit this field in the FreeAgent interface, but we haven’t found a corresponding field in the Bills API documentation or in the bill responses we’ve inspected.

Is there a supported API field or endpoint to read and update the Payment Reference? If not, is there a plan to expose it, or another supported way for an integration to populate it?

For clarity, we want to keep this separate from the bill’s main reference, which we use for our purchase order reference.

Many thanks,  
Mike
