FinancialsMisc. Annual Expenses

Misc. Annual Expenses

Retrieve a Single Annual Miscellaneous Expense by ID #

Method
GET
Endpoint
Sample Object

Retrieves a single Annual Miscellaneous Expense by its ID.

Parameters
Name Type Required? Description Details
id Number Yes
The id of the annual miscellaneous expense you would like to retrieve or change. Use the id returned for this expense.
$result_format String No
By default, the response is a single object. Send array to get it inside a one-item array.
Allowed values: array
$include_record_revision Boolean No
Set to true to include record_revision in the response. Send that value as expected_revision when updating to check for conflicting changes.
Default: false.
$on_error_return_empty_result Boolean No
For a missing or invalid expense id, or an expense not found, return HTTP 200 with {} (or [] when using array format). Authentication failures, a record that changes while it is read and unexpected errors keep their normal error status.

Working with annual expenses

These expenses appear under Annual Budgets and belong to a budget year, such as annual materials storage. The planned amount is your estimate; cost records the actual amount and its cost center breakdown.

The id returned by /v1/financials/misc_annual_expense_costs identifies the same expense and can be used with these methods.

Code Samples
curl -X GET "https://api.exhibitday.com/v1/financials/misc_annual_expenses/info?id=12345" -H "Authorization: Bearer YOUR_API_KEY"

Example response

{
  "id": 12345,
  "budget_year": 2026,
  "description": "Annual materials storage",
  "planned_amount": 150.00,
  "cost": {
    "amount": 125.50,
    "cost_center_breakdown": [
      {
        "cost_center_id": 34567,
        "cost_center": "Marketing",
        "charge": 75.50
      },
      {
        "cost_center_id": 34568,
        "cost_center": "Operations",
        "charge": 50.00
      }
    ]
  }
}
Note: IDs are illustrative; use IDs from your workspace.

List Annual Miscellaneous Expenses #

Method
GET
Endpoint

Lists the Annual Miscellaneous Expenses.

Parameters
Name Type Required? Description Details
filter_by_budget_year Number No
Only list the expenses of this budget year, for example 2030. Omit it for every year. Get saved years from GET /v1/references/budget_years.
$limit Number No
The most expenses to return, as a whole number of 1 or more. Omit it for all remaining expenses.
$offset Number No
How many expenses to skip before the first one returned (0 by default).
$result_format String No
By default, the response is an object containing list_data and the paging totals (records_found, total_records, has_more). Send array to get just a JSON array of the records, or wrapped_in_array to get the default object inside a one-item array.
Allowed values: array | wrapped_in_array

Good to know

Lists the Annual Miscellaneous Expenses of your workspace's annual budgets, ordered by budget year and then id, each with its planned amount and actual cost. Use filter_by_budget_year for one year.

Working with annual expenses

These expenses appear under Annual Budgets and belong to a budget year, such as annual materials storage. The planned amount is your estimate; cost records the actual amount and its cost center breakdown.

The id returned by /v1/financials/misc_annual_expense_costs identifies the same expense and can be used with these methods.

Code Samples
curl -X GET "https://api.exhibitday.com/v1/financials/misc_annual_expenses" -H "Authorization: Bearer YOUR_API_KEY"

Example response

{
  "records_found": 1,
  "total_records": 1,
  "has_more": false,
  "list_type": "misc_annual_expense",
  "list_data": [
    {
      "id": 12345,
      "budget_year": 2026,
      "description": "Annual materials storage",
      "planned_amount": 150.00,
      "cost": {
        "amount": 0.00,
        "cost_center_breakdown": []
      }
    }
  ]
}
Note: IDs are illustrative; use IDs from your workspace.

Create an Annual Miscellaneous Expense #

Method
POST
Endpoint

Adds an Annual Miscellaneous Expense.

Parameters
Name Type Required? Description Details
budget_year Number Yes
The budget year to add the expense to, such as 2026. Choose a year from GET /v1/references/budget_years. If that year does not have an annual budget yet, ExhibitDay creates it with zero planned budgets, the same way the Annual Budgets page does.
description String No
The description shown under Annual Budgets, up to 500 characters. Omit it or leave it blank to use Misc. Expense.
max length: 500
planned_amount Number No
The amount you plan to spend on this annual expense. Record Costs and Split Them Across Cost Centers.
A nonnegative scalar amount in your workspace currency, rounded to cents. Omit or leave blank on PATCH to keep it; null resets it to zero. Cost center allocations apply to the actual cost, not this planned amount.
cost Number or cost object No
The full cost, as a number or an object with amount and/or cost_center_breakdown. Record Costs and Split Them Across Cost Centers.
View value format and limits

File uploads use multipart form data. Other structured values use a JSON object or array; form/query values use JSON text.

{
  "anyOf": [
    {
      "type": "number",
      "minimum": 0,
      "description": "Shorthand for an object with amount. The amount is rounded to cents before the supported storage range is checked.",
      "nullable": true
    },
    {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "amount": {
          "type": "number",
          "minimum": 0.0,
          "maximum": 79228162514264337593543950335.0
        },
        "cost_center_breakdown": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "cost_center_id": {
                "type": "integer",
                "format": "int64",
                "nullable": true
              },
              "charge": {
                "type": "number",
                "minimum": 0.0,
                "maximum": 79228162514264337593543950335.0
              },
              "cost_center": {
                "type": "string",
                "description": "Optional and read-only: the cost center name a read returns, so a cost can be sent back unchanged. It is ignored; the line is saved by cost_center_id, and a name that doesn't match that cost center is explained in a warning.",
                "nullable": true
              }
            },
            "x-member-name-comparison": "ordinal-ignore-case; duplicate case variants are rejected",
            "required": [
              "charge"
            ]
          },
          "maxItems": 2147483647
        }
      },
      "x-member-name-comparison": "ordinal-ignore-case; duplicate case variants are rejected",
      "anyOf": [
        {
          "required": [
            "amount"
          ]
        },
        {
          "required": [
            "cost_center_breakdown"
          ]
        }
      ],
      "nullable": true
    }
  ],
  "x-numeric-shorthand": "A number is equivalent to {amount:number}.",
  "nullable": true,
  "x-maximum-depth": 3,
  "x-empty-create-means-omitted": true,
  "example": {
    "amount": 125.50
  }
}
Optional; defaults to zero.
$result_format String No
By default, the response is a single object. Send array to get it inside a one-item array.
Allowed values: array

Good to know

Adds a miscellaneous expense to an annual budget. Use cost for the actual amount and its cost center breakdown.

Working with annual expenses

These expenses appear under Annual Budgets and belong to a budget year, such as annual materials storage. The planned amount is your estimate; cost records the actual amount and its cost center breakdown.

The id returned by /v1/financials/misc_annual_expense_costs identifies the same expense and can be used with these methods.

Code Samples
curl -X POST "https://api.exhibitday.com/v1/financials/misc_annual_expenses" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{\"budget_year\":2030,\"description\":\"Sample description\",\"planned_amount\":100,\"cost\":{\"amount\":125.50}}"

Example response

{
  "id": 23456,
  "budget_year": 2030,
  "description": "Sample description",
  "planned_amount": 100.00,
  "cost": {
    "amount": 125.50,
    "cost_center_breakdown": [
      {
        "cost_center_id": null,
        "cost_center": "Not Specified",
        "charge": 125.50
      }
    ]
  }
}
Note: IDs are illustrative; use IDs from your workspace.

Update an Annual Miscellaneous Expense #

Method
PATCH
Endpoint

Updates an existing Annual Miscellaneous Expense.

Parameters
Name Type Required? Description Details
id Number Yes
The id of the annual miscellaneous expense you would like to retrieve or change. Use the id returned for this expense.
budget_year Number No
Optionally confirm the budget year for this expense. If supplied, it must match the current year; an existing expense cannot be moved to another budget year.
description String No
The description shown under Annual Budgets, up to 500 characters. Omit it or send a blank value to keep the current description. Send null to use Misc. Expense.
max length: 500
planned_amount Number No
The amount you plan to spend on this annual expense. Record Costs and Split Them Across Cost Centers.
A nonnegative scalar amount in your workspace currency, rounded to cents. Omit or leave blank on PATCH to keep it; null resets it to zero. Cost center allocations apply to the actual cost, not this planned amount.
cost Number or cost object No
The full cost, as a number or an object with amount and/or cost_center_breakdown. Record Costs and Split Them Across Cost Centers.
View value format and limits

File uploads use multipart form data. Other structured values use a JSON object or array; form/query values use JSON text.

{
  "anyOf": [
    {
      "type": "number",
      "minimum": 0,
      "description": "Shorthand for an object with amount. The amount is rounded to cents before the supported storage range is checked.",
      "nullable": true
    },
    {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "amount": {
          "type": "number",
          "minimum": 0.0,
          "maximum": 79228162514264337593543950335.0
        },
        "cost_center_breakdown": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "cost_center_id": {
                "type": "integer",
                "format": "int64",
                "nullable": true
              },
              "charge": {
                "type": "number",
                "minimum": 0.0,
                "maximum": 79228162514264337593543950335.0
              },
              "cost_center": {
                "type": "string",
                "description": "Optional and read-only: the cost center name a read returns, so a cost can be sent back unchanged. It is ignored; the line is saved by cost_center_id, and a name that doesn't match that cost center is explained in a warning.",
                "nullable": true
              }
            },
            "x-member-name-comparison": "ordinal-ignore-case; duplicate case variants are rejected",
            "required": [
              "charge"
            ]
          },
          "maxItems": 2147483647
        }
      },
      "x-member-name-comparison": "ordinal-ignore-case; duplicate case variants are rejected",
      "anyOf": [
        {
          "required": [
            "amount"
          ]
        },
        {
          "required": [
            "cost_center_breakdown"
          ]
        }
      ],
      "nullable": true
    }
  ],
  "x-numeric-shorthand": "A number is equivalent to {amount:number}.",
  "nullable": true,
  "x-maximum-depth": 3,
  "x-empty-create-means-omitted": true,
  "example": {
    "amount": 125.50
  }
}
Omit to keep the saved cost. A supplied value replaces its full allocation.
expected_revision String No
The record_revision returned when you retrieved this record. Include it to avoid overwriting someone else's changes. Omit it to skip this check.

Good to know

Updates an Annual Miscellaneous Expense. Include only the fields you want to change.

Working with annual expenses

These expenses appear under Annual Budgets and belong to a budget year, such as annual materials storage. The planned amount is your estimate; cost records the actual amount and its cost center breakdown.

The id returned by /v1/financials/misc_annual_expense_costs identifies the same expense and can be used with these methods.

Code Samples
curl -X PATCH "https://api.exhibitday.com/v1/financials/misc_annual_expenses" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{\"id\":12345,\"description\":\"Updated description\"}"

Example response

{
  "status_code": 200,
  "status": "OK",
  "message": "Annual expense updated.",
  "errors": []
}

Delete an Annual Miscellaneous Expense #

Method
DELETE
Endpoint

Permanently removes an Annual Miscellaneous Expense and its recorded cost.

Note: Inputs that do not apply to this operation, including the ignore-empty option, are ignored and reported in the X-API-Warnings response header.

Parameters
Name Type Required? Description Details
id Number Yes
The id of the annual miscellaneous expense you would like to retrieve or change. Use the id returned for this expense.

Working with annual expenses

These expenses appear under Annual Budgets and belong to a budget year, such as annual materials storage. The planned amount is your estimate; cost records the actual amount and its cost center breakdown.

The id returned by /v1/financials/misc_annual_expense_costs identifies the same expense and can be used with these methods.

Code Samples
curl -X DELETE "https://api.exhibitday.com/v1/financials/misc_annual_expenses?id=12345" -H "Authorization: Bearer YOUR_API_KEY"

Example response

{
  "status_code": 200,
  "status": "OK",
  "message": "Annual expense removed.",
  "errors": []
}

Retrieve Miscellaneous Annual Expense Costs #

Method
GET
Endpoint

Retrieves the costs recorded on Annual Miscellaneous Expenses.

Parameters
Name Type Required? Description Details
filter_by_budget_year Number No
Only return the miscellaneous annual expense costs of this budget year, for example 2030. Omit it (or send all) for every year. budget_year is an older name for this parameter and is still accepted; send one of them.
$limit Number No
The most cost records to return (a whole number of 1 or more). Use it with $offset to read a long list in pages: total_records in the response counts every matching cost record and has_more is true while more pages follow (the X-Total-Count header carries the total too). Without $limit, every matching cost record is returned.
$offset Number No
How many cost records to skip before the first one returned (a whole number; 0 by default). For the next page, add the number of cost records you received to $offset.
$result_format String No
By default, the response is an object containing list_data and the paging totals (records_found, total_records, has_more). Send array to get just a JSON array of the records, or wrapped_in_array to get the default object inside a one-item array.
Allowed values: array | wrapped_in_array
$on_error_return_empty_result Boolean No
For invalid filter_by_budget_year (or budget_year) or paging values, return HTTP 200 with no matching records in the selected result format. Authentication, rate-limit and unexpected server errors keep their normal HTTP status.
Default: false.

Good to know

If a specific Budget Year is passed in (using the "filter_by_budget_year" parameter, e.g. 2026), then only the miscellaneous annual expense costs for that budget year are returned. Otherwise, all miscellaneous annual expense costs for all budget years are returned. Every miscellaneous annual expense is listed, including one with a planned amount and no cost recorded yet (its actual_amount is 0 and its actual_amount_cost_center_breakdown is empty).

Code Samples
curl -X GET "https://api.exhibitday.com/v1/financials/misc_annual_expense_costs" -H "Authorization: Bearer YOUR_API_KEY"

Example response

{
  "records_found": 1,
  "total_records": 1,
  "has_more": false,
  "list_type": "misc_annual_expense_cost",
  "list_data": [
    {
      "id": 12345,
      "budget_year": 2026,
      "description": "Sample annual expense",
      "planned_amount": 150.00,
      "cost": {
        "amount": 125.50,
        "cost_center_breakdown": [
          {
            "cost_center_id": null,
            "cost_center": "Not Specified",
            "charge": 125.50
          }
        ]
      },
      "actual_amount": 125.50,
      "actual_amount_cost_center_breakdown": [
        {
          "cost_center_id": null,
          "cost_center": "Not Specified",
          "charge": 125.50
        }
      ]
    }
  ]
}
Note: IDs are illustrative; use IDs from your workspace.