# Xero Assets API API

> Xero Assets API API on Apizie: 6 endpoints (searches fixed asset, adds a fixed asset, Retrieves fixed asset by id, searches fixed asset types, …) 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://apizie.tech/v1/finance:xero-xero-assets/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

The Assets API exposes fixed asset related functions of the Xero Accounting application and can be used for a variety of purposes such as creating assets, retrieving asset valuations etc.

## Endpoints

### searches fixed asset
`GET https://apizie.tech/v1/finance:xero-xero-assets/get-assets` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| xero-tenant-id | string | yes | Xero identifier for Tenant |
| status | string | yes | Required when retrieving a collection of assets. See Asset Status Codes |
| page | integer | no | Results are paged. This specifies which page of the results to return. The default page is 1. |
| pageSize | integer | no | The number of records returned per page. By default the number of records returned is 10. |
| orderBy | string | no | Requests can be ordered by AssetType, AssetName, AssetNumber, PurchaseDate and PurchasePrice. If the asset status is DISPOSED it also… |
| sortDirection | string | no | ASC or DESC |
| filterBy | string | no | A string that can be used to filter the list to only return assets containing the text. Checks it against the AssetName, AssetNumber,… |

### adds a fixed asset
`POST https://apizie.tech/v1/finance:xero-xero-assets/create-asset` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| xero-tenant-id | string | yes | Xero identifier for Tenant |
| Idempotency-Key | string | no | This allows you to safely retry requests without the risk of duplicate processing. 128 character max. |
| body | object | yes | JSON request body |

### Retrieves fixed asset by id
`GET https://apizie.tech/v1/finance:xero-xero-assets/get-asset-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| xero-tenant-id | string | yes | Xero identifier for Tenant |
| id | string | yes | fixed asset id for single object |

### searches fixed asset types
`GET https://apizie.tech/v1/finance:xero-xero-assets/get-asset-types` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| xero-tenant-id | string | yes | Xero identifier for Tenant |

### adds a fixed asset type
`POST https://apizie.tech/v1/finance:xero-xero-assets/create-asset-type` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| xero-tenant-id | string | yes | Xero identifier for Tenant |
| Idempotency-Key | string | no | This allows you to safely retry requests without the risk of duplicate processing. 128 character max. |
| body | object | yes | JSON request body |

### searches fixed asset settings
`GET https://apizie.tech/v1/finance:xero-xero-assets/get-asset-settings` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| xero-tenant-id | string | yes | Xero identifier for Tenant |

## Example
```
curl "https://apizie.tech/v1/finance:xero-xero-assets/get-assets" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Xero Assets API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/finance:xero-xero-assets/get-assets with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

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

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