# FreeAgent API

> FreeAgent API on Apizie: 152 endpoints (Refresh access token, List all clients, List all account managers, Get a single account manager, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/finance:freeagent/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `finance:freeagent`
- Category: Finance
- Status: byok
- Source: https://freeagent.com
- Page: https://www.apizie.tech/api/finance/freeagent
- OpenAPI: https://www.apizie.tech/api/finance/freeagent/openapi.json

One product.🤳 17 years. 📆 250+ employees. 🧑‍💻Over 150,000 users. 💥There's so much to say about it all. But here's the version that fits the character limit. We're FreeAgent. 👋 We make award-winning accounting…

## Endpoints

### Refresh access token
`POST https://www.apizie.tech/v1/finance:freeagent/authorization-refresh-access-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### List all clients
`GET https://www.apizie.tech/v1/finance:freeagent/accountancy-practice-api-get-all-clients` (byok)

### List all account managers
`GET https://www.apizie.tech/v1/finance:freeagent/accountancy-practice-api-list-account-managers` (byok)

### Get a single account manager
`GET https://www.apizie.tech/v1/finance:freeagent/accountancy-practice-api-get-account-manager` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Show Attachment
`GET https://www.apizie.tech/v1/finance:freeagent/attachments-show-attachment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Delete Attachment
`POST https://www.apizie.tech/v1/finance:freeagent/attachments-delete-attachment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### List Bank Accounts
`GET https://www.apizie.tech/v1/finance:freeagent/bank-accounts-list-bank-accounts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| view | string | no |  |

### Create Bank Account
`POST https://www.apizie.tech/v1/finance:freeagent/bank-accounts-create-new-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Show Bank Account
`GET https://www.apizie.tech/v1/finance:freeagent/bank-accounts-show-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Update Bank Account
`POST https://www.apizie.tech/v1/finance:freeagent/bank-accounts-update-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Delete Bank Account
`POST https://www.apizie.tech/v1/finance:freeagent/bank-accounts-delete-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### List all bank transaction explanations
`GET https://www.apizie.tech/v1/finance:freeagent/bank-transaction-explanations-list-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| from_date | string | no |  |
| to_date | string | no |  |
| updated_since | string | no |  |
| bank_account | string | no |  |

### Create a bank transaction explanation
`POST https://www.apizie.tech/v1/finance:freeagent/bank-transaction-explanations-create-explanation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Update a bank transaction explanation
`POST https://www.apizie.tech/v1/finance:freeagent/bank-transaction-explanations-update-explanation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Get a single bank transaction explanation
`GET https://www.apizie.tech/v1/finance:freeagent/bank-transaction-explanations-get-single-explanation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Delete a bank transaction explanation
`POST https://www.apizie.tech/v1/finance:freeagent/bank-transaction-explanations-delete-explanation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### List all bank transactions under a certain bank account
`GET https://www.apizie.tech/v1/finance:freeagent/bank-transactions-list-under-account` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| bank_account | string | no |  |
| from_date | string | no |  |
| to_date | string | no |  |
| updated_since | string | no |  |
| view | string | no |  |
| last_uploaded | string | no |  |

### Get a single bank transaction
`GET https://www.apizie.tech/v1/finance:freeagent/bank-transactions-get-single-transaction` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Upload a bank statement
`POST https://www.apizie.tech/v1/finance:freeagent/bank-transactions-upload-statement` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| bank_account | string | no |  |
| body | object | no | JSON request body |

### List Bills
`GET https://www.apizie.tech/v1/finance:freeagent/bills-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| view | string | no |  |
| from_date | string | no |  |
| to_date | string | no |  |
| updated_since | string | no |  |
| contact | string | no |  |
| project | string | no |  |

### Create Bill
`POST https://www.apizie.tech/v1/finance:freeagent/bills-create-bill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Show Bill
`GET https://www.apizie.tech/v1/finance:freeagent/bills-get-bill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Update Bill
`POST https://www.apizie.tech/v1/finance:freeagent/bills-update-bill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Delete Bill
`POST https://www.apizie.tech/v1/finance:freeagent/bills-delete-bill` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### List Bill Items
`GET https://www.apizie.tech/v1/finance:freeagent/bill-items-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| bill | string | no |  |

### Show Bill Item
`GET https://www.apizie.tech/v1/finance:freeagent/bill-items-get-item` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| bill_item_id | string | yes |  |

### List all capital assets
`GET https://www.apizie.tech/v1/finance:freeagent/capital-assets-get-all-assets` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| include_history | string | no | Retrieves information about events in the capital asset life cycle (such as purchase, depreciation, and disposal). |

### List all capital asset types
`GET https://www.apizie.tech/v1/finance:freeagent/capital-asset-types-list-all` (byok)

### Create capital asset type
`POST https://www.apizie.tech/v1/finance:freeagent/capital-asset-types-create-new-type` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Get a single capital asset type
`GET https://www.apizie.tech/v1/finance:freeagent/capital-asset-types-get-single` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Update capital asset type
`POST https://www.apizie.tech/v1/finance:freeagent/capital-asset-types-update-type` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Delete capital asset type
`POST https://www.apizie.tech/v1/finance:freeagent/capital-asset-types-delete-type` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Cashflow summary for a given date range
`GET https://www.apizie.tech/v1/finance:freeagent/cashflow-summary-for-given-date-range` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| from_date | string | no |  |
| to_date | string | no |  |

### List Categories
`GET https://www.apizie.tech/v1/finance:freeagent/categories-list` (byok)

### Create category
`POST https://www.apizie.tech/v1/finance:freeagent/categories-create-category` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Get a single category
`GET https://www.apizie.tech/v1/finance:freeagent/categories-get-single-category` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| nominal_code | string | yes |  |

### Update category
`POST https://www.apizie.tech/v1/finance:freeagent/categories-update-category` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| nominal_code | string | yes |  |
| body | object | no | JSON request body |

### Delete category
`POST https://www.apizie.tech/v1/finance:freeagent/categories-remove-category` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| nominal_code | string | yes |  |

### List all CIS bands for a company
`GET https://www.apizie.tech/v1/finance:freeagent/cis-bands-list-all-for-company` (byok)

### Company Details
`GET https://www.apizie.tech/v1/finance:freeagent/company-details-get` (byok)

### List business categories
`GET https://www.apizie.tech/v1/finance:freeagent/company-list-business-categories` (byok)

### Show Tax Timeline
`GET https://www.apizie.tech/v1/finance:freeagent/company-show-tax-timeline` (byok)

### List Contacts
`GET https://www.apizie.tech/v1/finance:freeagent/contacts-list` (byok)

### Create Contact
`POST https://www.apizie.tech/v1/finance:freeagent/contacts-add-new-contact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Show Contact
`GET https://www.apizie.tech/v1/finance:freeagent/contacts-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Update Contact
`POST https://www.apizie.tech/v1/finance:freeagent/contacts-update-contact-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Delete Contact
`POST https://www.apizie.tech/v1/finance:freeagent/contacts-delete-contact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Mark Credit Note as sent
`POST https://www.apizie.tech/v1/finance:freeagent/credit-notes-mark-as-sent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Mark Credit Note as cancelled
`POST https://www.apizie.tech/v1/finance:freeagent/credit-notes-mark-as-cancelled` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Mark Credit Notes as draft
`POST https://www.apizie.tech/v1/finance:freeagent/credit-notes-mark-as-draft` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### List Credit Notes
`GET https://www.apizie.tech/v1/finance:freeagent/credit-notes-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| contact | string | no |  |
| project | string | no |  |
| currency | string | no |  |
| view | string | no |  |
| updated_since | string | no |  |
| sort | string | no |  |
| nested_credit_note_items | string | no |  |

### Create Credit Note
`POST https://www.apizie.tech/v1/finance:freeagent/credit-notes-create-new-credit-note` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Show Credit Note
`GET https://www.apizie.tech/v1/finance:freeagent/credit-notes-show-credit-note` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Update Credit Note
`POST https://www.apizie.tech/v1/finance:freeagent/credit-notes-update-credit-note` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Delete Credit Notes
`POST https://www.apizie.tech/v1/finance:freeagent/credit-notes-delete-credit-note` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | Form fields as a JSON object |

### Show Credit Note as PDF
`GET https://www.apizie.tech/v1/finance:freeagent/credit-notes-show-pdf` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Send Credit Note Email
`POST https://www.apizie.tech/v1/finance:freeagent/credit-notes-send-email` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### List Credit Note Reconciliations
`GET https://www.apizie.tech/v1/finance:freeagent/credit-note-reconciliations-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| updated_since | string | no |  |
| from_date | string | no |  |
| to_date | string | no |  |

### Create Credit Note Reconciliation
`POST https://www.apizie.tech/v1/finance:freeagent/credit-note-reconciliations-create-reconciliation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Show Credit Note Reconciliation
`GET https://www.apizie.tech/v1/finance:freeagent/credit-note-reconciliations-show-reconciliation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Update Credit Note Reconciliation
`POST https://www.apizie.tech/v1/finance:freeagent/credit-note-reconciliations-update-reconciliation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Delete Credit Note Reconciliation
`POST https://www.apizie.tech/v1/finance:freeagent/credit-note-reconciliations-delete-reconciliation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | Form fields as a JSON object |

### Get a list of verified sender email addresses
`GET https://www.apizie.tech/v1/finance:freeagent/email-addresses-list-verified` (byok)

### Mark estimate as sent
`POST https://www.apizie.tech/v1/finance:freeagent/estimates-mark-as-sent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Mark estimate as draft
`POST https://www.apizie.tech/v1/finance:freeagent/estimates-mark-as-draft` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Mark estimate as approved
`POST https://www.apizie.tech/v1/finance:freeagent/estimates-mark-as-approved` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Mark estimate as rejected
`POST https://www.apizie.tech/v1/finance:freeagent/estimates-mark-as-rejected` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Create Estimate Item
`POST https://www.apizie.tech/v1/finance:freeagent/estimates-create-item` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Update Estimate Item
`POST https://www.apizie.tech/v1/finance:freeagent/estimates-update-item` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Delete Estimate Item
`POST https://www.apizie.tech/v1/finance:freeagent/estimates-delete-item` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### List Estimates
`GET https://www.apizie.tech/v1/finance:freeagent/estimates-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| view | string | no |  |
| from_date | string | no |  |
| to_date | string | no |  |
| updated_since | string | no |  |
| nested_estimate_items | string | no |  |
| contact | string | no |  |
| project | string | no |  |
| invoice | string | no |  |

### Create Estimate
`POST https://www.apizie.tech/v1/finance:freeagent/estimates-create-new` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Show Estimate
`GET https://www.apizie.tech/v1/finance:freeagent/estimates-show-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Update Estimate
`POST https://www.apizie.tech/v1/finance:freeagent/estimates-update-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Delete Estimate
`POST https://www.apizie.tech/v1/finance:freeagent/estimates-delete-estimate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Show Estimate as PDF
`GET https://www.apizie.tech/v1/finance:freeagent/estimates-get-as-pdf` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### List all expenses
`GET https://www.apizie.tech/v1/finance:freeagent/expenses-get-all` (byok)

### Create expense
`POST https://www.apizie.tech/v1/finance:freeagent/expenses-create-expense` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Get a single expense
`GET https://www.apizie.tech/v1/finance:freeagent/expenses-get-single-expense` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Delete expense
`POST https://www.apizie.tech/v1/finance:freeagent/expenses-delete-expense` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | Form fields as a JSON object |

### Get mileage settings
`GET https://www.apizie.tech/v1/finance:freeagent/expenses-get-mileage-settings` (byok)

### Mark invoice as sent
`POST https://www.apizie.tech/v1/finance:freeagent/invoices-mark-as-sent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Mark invoice as cancelled
`POST https://www.apizie.tech/v1/finance:freeagent/invoices-mark-as-cancelled` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Mark invoice as scheduled
`POST https://www.apizie.tech/v1/finance:freeagent/invoices-mark-as-scheduled` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Mark invoice as draft
`POST https://www.apizie.tech/v1/finance:freeagent/invoices-mark-as-draft` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### List Invoices
`GET https://www.apizie.tech/v1/finance:freeagent/invoices-get-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| nested_invoice_items | string | no |  |
| contact | string | no |  |
| project | string | no |  |
| currency | string | no |  |
| view | string | no |  |
| updated_since | string | no |  |
| sort | string | no |  |

### Create Invoice
`POST https://www.apizie.tech/v1/finance:freeagent/invoices-create-new-invoice` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Show Invoice
`GET https://www.apizie.tech/v1/finance:freeagent/invoices-show-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Update Invoice
`POST https://www.apizie.tech/v1/finance:freeagent/invoices-update-invoice-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Delete Invoice
`POST https://www.apizie.tech/v1/finance:freeagent/invoices-delete-invoice` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | Form fields as a JSON object |

### Get invoice timeline
`GET https://www.apizie.tech/v1/finance:freeagent/invoices-get-timeline` (byok)

### Show Invoice as PDF
`GET https://www.apizie.tech/v1/finance:freeagent/invoices-get-pdf` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Send Invoice Email
`POST https://www.apizie.tech/v1/finance:freeagent/invoices-send-email` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Take Payment using GoCardless Direct Debit Mandate
`POST https://www.apizie.tech/v1/finance:freeagent/invoices-take-payment-using-go-cardless-direct-debit-mandate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Create Invoice Item
`POST https://www.apizie.tech/v1/finance:freeagent/invoices-add-new-invoice-item` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### List all journal sets
`GET https://www.apizie.tech/v1/finance:freeagent/journal-sets-list-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| to_date | string | no |  |
| from_date | string | no |  |
| tag | string | no |  |

### Create a journal set
`POST https://www.apizie.tech/v1/finance:freeagent/journal-sets-create-new-set` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Update a journal set
`POST https://www.apizie.tech/v1/finance:freeagent/journal-sets-update-journal-set` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Get a single journal set
`GET https://www.apizie.tech/v1/finance:freeagent/journal-sets-get-single-set` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Delete a journal set
`POST https://www.apizie.tech/v1/finance:freeagent/journal-sets-delete-set` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Get the Opening Balances
`GET https://www.apizie.tech/v1/finance:freeagent/journal-sets-get-opening-balances` (byok)

### List Notes
`GET https://www.apizie.tech/v1/finance:freeagent/notes-get-all-notes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| contact | string | no |  |
| project | string | no |  |

### Get a single note
`GET https://www.apizie.tech/v1/finance:freeagent/notes-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Create a Note
`POST https://www.apizie.tech/v1/finance:freeagent/notes-create-note` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| contact | string | no |  |
| project | string | no |  |
| body | object | no | JSON request body |

### Update a Note
`POST https://www.apizie.tech/v1/finance:freeagent/notes-update-note-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Delete a note
`POST https://www.apizie.tech/v1/finance:freeagent/notes-delete-note` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### List all periods for a given tax year
`GET https://www.apizie.tech/v1/finance:freeagent/payroll-list-periods-for-year` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| year | string | yes |  |

### List all payslips for a given period
`GET https://www.apizie.tech/v1/finance:freeagent/payroll-payslips-for-period` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| year | string | yes |  |
| period | string | yes |  |

### List all profiles for a given tax year
`GET https://www.apizie.tech/v1/finance:freeagent/payroll-profiles-list-for-given-year` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| year | string | yes |  |
| user | string | no |  |

### List all Price List Items
`GET https://www.apizie.tech/v1/finance:freeagent/price-list-items-get-all` (byok)

### Get a single Price List Item
`GET https://www.apizie.tech/v1/finance:freeagent/price-list-items-get-single-item` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Get the P&L summary
`GET https://www.apizie.tech/v1/finance:freeagent/profit-loss-summary-get` (byok)

### List all properties
`GET https://www.apizie.tech/v1/finance:freeagent/properties-list-all-properties` (byok)

### Create a new property
`POST https://www.apizie.tech/v1/finance:freeagent/properties-create-new-property` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Get a single property
`GET https://www.apizie.tech/v1/finance:freeagent/properties-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### Update a property
`POST https://www.apizie.tech/v1/finance:freeagent/properties-update-property` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| body | object | no | JSON request body |

### Delete a property
`POST https://www.apizie.tech/v1/finance:freeagent/properties-remove-property` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |

### List Projects
`GET https://www.apizie.tech/v1/finance:freeagent/projects-get-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| contact | string | no |  |
| nested | string | no | Retrieves contact's details as nested JSON objects rather than URL references. |

### Create Project
`POST https://www.apizie.tech/v1/finance:freeagent/projects-create-new-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Show Project
`GET https://www.apizie.tech/v1/finance:freeagent/projects-show-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes |  |
| nested | string | no | Retrieves contact's details as nested JSON objects rather than URL references. |

…and 32 more. See the OpenAPI spec.

## Example
```
curl "https://www.apizie.tech/v1/finance:freeagent/authorization-refresh-access-token" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the FreeAgent API?
Create a free Apizie key, then send POST https://www.apizie.tech/v1/finance:freeagent/authorization-refresh-access-token with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the FreeAgent API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. FreeAgent itself also needs your own key from api.freeagent.com.

### Can AI agents use the FreeAgent API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key finance:freeagent.

### What is the status of the FreeAgent API?
Needs your own provider key (bring your own key)