---
agentTools:
  projectIndex: https://developer.bill.com/llms.txt
---

# New v3 API endpoints for Spend & Expense custom field operations

We have introduced a set of API endpoints for the Spend & Expense custom field operations. A custom field enables you to categorize transactions in a budget based on policies and projects in your organization.

| Operation                                                                                                              | API endpoint                                                                      |
| :--------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------- |
| [Create a custom field](https://developer.bill.com/reference/createcustomfield)                                        | `POST /v3/spend/custom-fields`                                                    |
| [Get list of custom fields](https://developer.bill.com/reference/listcustomfields)                                     | `GET /v3/spend/custom-fields`                                                     |
| [Get custom field details](https://developer.bill.com/reference/getcustomfield)                                        | `GET /v3/spend/custom-fields/{customFieldId}`                                     |
| [Update a custom field](https://developer.bill.com/reference/updatecustomfield)                                        | `PATCH /v3/spend/custom-fields/{customFieldId}`                                   |
| [Delete a custom field](https://developer.bill.com/reference/deletecustomfield)                                        | `DELETE /v3/spend/custom-fields/{customFieldId}`                                  |
| [Create custom field values](https://developer.bill.com/reference/createcustomfieldvalues)                             | `POST /v3/spend/custom-fields/{customFieldId}/values`                             |
| [Get list of custom field values](https://developer.bill.com/reference/listcustomfieldvalues)                          | `GET /v3/spend/custom-fields/{customFieldId}/values`                              |
| [Get custom field value details](https://developer.bill.com/reference/getcustomfieldvalues)                            | `GET /v3/spend/custom-fields/{customFieldId}/values/{customFieldValueId}`         |
| [Delete custom field values](https://developer.bill.com/reference/deletecustomfieldvalue)                              | `DELETE /v3/spend/custom-fields/{customFieldId}/values`                           |
| [Update custom field and values for a transaction](https://developer.bill.com/reference/updatetransactioncustomfields) | `PUT /v3/spend/transactions/{transactionId}/custom-fields`                        |
| [Get custom field details for a transaction](https://developer.bill.com/reference/listtransactioncustomfields)         | `GET /v3/spend/transactions/{transactionId}/custom-fields`                        |
| [Get custom field value details for a transaction](https://developer.bill.com/reference/listtransactioncustomfields)   | `GET /v3/spend/transactions/{transactionId}/custom-fields/{customFieldId}/values` |