---
title: "You cannot create budget line adjustments via this API (See budget_lines/:id/adjust)"
method: POST
path: "/budget_line_adjustments"
tags: ["BudgetLineAdjustment"]
---

# You cannot create budget line adjustments via this API (See budget_lines/:id/adjust)

`POST /budget_line_adjustments`

## Request

- Base URL: `https://r38.coupadev.com/api`
- URL: `https://r38.coupadev.com/api/budget_line_adjustments`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://r38.coupadev.com/oauth2/authorizations/new`
    - Token URL: `https://r38.coupadev.com/oauth2/token`
  - OAuth 2
    - Client credentials
    - Token URL: `https://r38.coupadev.com/oauth2/access_tokens`
- TypeScript: <https://skmtc.dev/coupa/apis/coupa-api-4/docs/budget_line_adjustments/post.ts> (a function with typed inputs; its response is checked against the schema)

You cannot create budget line adjustments via this API (See budget_lines/:id/adjust)

## Query parameters

- `return_object` 'limited' | 'shallow' | 'none'
- `filter` string

## Request body

- BudgetLineAdjustment
  - `accounting-total` number: accounting_total
  - `adjuster` unknown
  - `adjustment-amount` number: amount
  - `amount` number: amount
  - `budget-line` BudgetLine, required
    - `amount` number: amount
    - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `created-by` UserSimple
      - `avatar-thumb-url` string, string: Avatar url
      - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `email` string, string(255), required: email
      - `employee-number` string, string(255): employee number
      - `firstname` string, string(40), required: first name
      - `fullname` string, string(255): full name
      - `id` integer: Coupa unique identifier
      - `lastname` string, string(40), required: last name
      - `login` string, string(255), required: login
      - `salesforce-id` string, string(255), required: salesforce_id
      - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `currency` Currency
      - `code` string, string(6), required: code
      - `decimals` integer: Decimal precision
      - `enabled` boolean: Enabled
      - `id` integer: Coupa unique identifier
      - `name` string, string(100), required: name
      - `symbol` string, string(10): symbol
    - `description` string, string(255): description
    - `error-on-overrun` boolean: Prevent submission of requisitions that would exceed the budget
    - `id` integer: Coupa unique identifier
    - `notes` string, text: notes
    - `overrun-calculation` integer: Overrun Calculation
    - `owner` UserSimple
      - `avatar-thumb-url` string, string: Avatar url
      - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `email` string, string(255), required: email
      - `employee-number` string, string(255): employee number
      - `firstname` string, string(40), required: first name
      - `fullname` string, string(255): full name
      - `id` integer: Coupa unique identifier
      - `lastname` string, string(40), required: last name
      - `login` string, string(255), required: login
      - `salesforce-id` string, string(255), required: salesforce_id
      - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `owner-is-approver` integer: Owner is approver?
    - `pending-requisitions-amount` number: Amount consumed by pending requisitions
    - `period` Period, required
      - `account-type` AccountType
        - `active` boolean: A false value will inactivate the chart of account making it no longer available to users. A true value will make it active and available to users.
        - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
        - `created-by` UserSimple
          - `avatar-thumb-url` string, string: Avatar url
          - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `email` string, string(255), required: email
          - `employee-number` string, string(255): employee number
          - `firstname` string, string(40), required: first name
          - `fullname` string, string(255): full name
          - `id` integer: Coupa unique identifier
          - `lastname` string, string(40), required: last name
          - `login` string, string(255), required: login
          - `salesforce-id` string, string(255), required: salesforce_id
          - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
        - `currency` Currency, required
          - `code` string, string(6), required: code
          - `decimals` integer: Decimal precision
          - `enabled` boolean: Enabled
          - `id` integer: Coupa unique identifier
          - `name` string, string(100), required: name
          - `symbol` string, string(10): symbol
        - `dynamic-flag` boolean: Boolean value for determing if account type is dynamic
        - `id` integer: Coupa unique identifier
        - `legal-entity-name` string, string: Legal entity or entities that are associated with this chart of accounts
        - `name` string, string(50), required: name
        - `primary-address` Address
          - `active` boolean: A no value will make the address inactive making it no longer available to users. A yes value will make it active and available to users.
          - `attention` string, string(255): Address Default Attention Line
          - `business-group-name` string, string: Content Group Name for Address
          - `city` string, string(255), required: City Name
          - `content-groups` BusinessGroup[]
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `created-by` UserSimple
              - …
            - `description` string, string(255): description
            - `id` integer: Coupa unique identifier
            - `name` string, string(100), required: name
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `updated-by` UserSimple
              - …
          - `country` Country, required
            - `code` string, string(4), required: code
            - `created-at` string: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `id` integer: Coupa unique identifier
            - `name` string, string(100): name
            - `updated-at` string: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `created-by` UserSimple
            - `avatar-thumb-url` string, string: Avatar url
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `email` string, string(255), required: email
            - `employee-number` string, string(255): employee number
            - `firstname` string, string(40), required: first name
            - `fullname` string, string(255): full name
            - `id` integer: Coupa unique identifier
            - `lastname` string, string(40), required: last name
            - `login` string, string(255), required: login
            - `salesforce-id` string, string(255), required: salesforce_id
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `id` integer: Coupa Internal Address ID
          - `local-tax-number` string, string(255), required: Local Tax Number
          - `location-code` string, string(255): location_code
          - `name` string, string(255): Address 'Nickname'
          - `postal-code` string, string(255), required: Postal Code
          - `purposes` Purpose[]
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `created-by` UserSimple
              - …
            - `id` integer: Coupa unique identifier
            - `kind` string, string(255), required: Kind
            - `name` string, string(255), required: Name
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `updated-by` UserSimple
              - …
          - `state` string, string(255): State Name for Address
          - `state-iso-code` string, string(255): ISO Code for the State
          - `street1` string, string(255), required: Address Line 1
          - `street2` string, string(255): Address Line 2
          - `street3` string, string(255): Address Line 3
          - `street4` string, string(255): Address Line 4
          - `tax-registrations` Address[]
          - `type` string, string(255): Address type
          - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `updated-by` UserSimple
            - `avatar-thumb-url` string, string: Avatar url
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `email` string, string(255), required: email
            - `employee-number` string, string(255): employee number
            - `firstname` string, string(40), required: first name
            - `fullname` string, string(255): full name
            - `id` integer: Coupa unique identifier
            - `lastname` string, string(40), required: last name
            - `login` string, string(255), required: login
            - `salesforce-id` string, string(255), required: salesforce_id
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `vat-country` Country
            - `code` string, string(4), required: code
            - `created-at` string: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `id` integer: Coupa unique identifier
            - `name` string, string(100): name
            - `updated-at` string: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `vat-number` string, string(255): VAT identification number used for value added tax purposes
        - `primary-contact` Contact
          - `active` boolean: Active
          - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `created-by` UserSimple
            - `avatar-thumb-url` string, string: Avatar url
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `email` string, string(255), required: email
            - `employee-number` string, string(255): employee number
            - `firstname` string, string(40), required: first name
            - `fullname` string, string(255): full name
            - `id` integer: Coupa unique identifier
            - `lastname` string, string(40), required: last name
            - `login` string, string(255), required: login
            - `salesforce-id` string, string(255), required: salesforce_id
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `email` string, string(255): email
          - `id` integer: Coupa unique identifier
          - `name-additional` string, string(255): name_additional
          - `name-family` string, string(255): name_family
          - `name-fullname` string, string(255): name_fullname
          - `name-given` string, string(255): name_given
          - `name-prefix` string, string(255): name_prefix
          - `name-suffix` string, string(255): name_suffix
          - `notes` string, text: notes
          - `phone-fax` PhoneNumber
            - `area-code` string, string(255): area_code
            - `country-code` string, string(255): country_code
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `created-by` UserSimple
              - …
            - `extension` string, string(255): extension
            - `id` integer: Coupa unique identifier
            - `number` string, string(255): number
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `updated-by` UserSimple
              - …
          - `phone-mobile` PhoneNumber
            - `area-code` string, string(255): area_code
            - `country-code` string, string(255): country_code
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `created-by` UserSimple
              - …
            - `extension` string, string(255): extension
            - `id` integer: Coupa unique identifier
            - `number` string, string(255): number
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `updated-by` UserSimple
              - …
          - `phone-work` PhoneNumber
            - `area-code` string, string(255): area_code
            - `country-code` string, string(255): country_code
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `created-by` UserSimple
              - …
            - `extension` string, string(255): extension
            - `id` integer: Coupa unique identifier
            - `number` string, string(255): number
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `updated-by` UserSimple
              - …
          - `photo` string, string(255): photo
          - `purposes` Purpose[]
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `created-by` UserSimple
              - …
            - `id` integer: Coupa unique identifier
            - `kind` string, string(255), required: Kind
            - `name` string, string(255), required: Name
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `updated-by` UserSimple
              - …
          - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `updated-by` UserSimple
            - `avatar-thumb-url` string, string: Avatar url
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `email` string, string(255), required: email
            - `employee-number` string, string(255): employee number
            - `firstname` string, string(40), required: first name
            - `fullname` string, string(255): full name
            - `id` integer: Coupa unique identifier
            - `lastname` string, string(40), required: last name
            - `login` string, string(255), required: login
            - `salesforce-id` string, string(255), required: salesforce_id
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
        - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
        - `updated-by` UserSimple
          - `avatar-thumb-url` string, string: Avatar url
          - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `email` string, string(255), required: email
          - `employee-number` string, string(255): employee number
          - `firstname` string, string(40), required: first name
          - `fullname` string, string(255): full name
          - `id` integer: Coupa unique identifier
          - `lastname` string, string(40), required: last name
          - `login` string, string(255), required: login
          - `salesforce-id` string, string(255), required: salesforce_id
          - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `created-by` UserSimple
        - `avatar-thumb-url` string, string: Avatar url
        - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
        - `email` string, string(255), required: email
        - `employee-number` string, string(255): employee number
        - `firstname` string, string(40), required: first name
        - `fullname` string, string(255): full name
        - `id` integer: Coupa unique identifier
        - `lastname` string, string(40), required: last name
        - `login` string, string(255), required: login
        - `salesforce-id` string, string(255), required: salesforce_id
        - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `end-date` string, datetime, required: end_date
      - `id` integer: Coupa unique identifier
      - `is-open` boolean: is_open
      - `name` string, string(100), required: name
      - `segment-1` boolean: segment_1
      - `segment-10` boolean: segment_10
      - `segment-11` boolean: segment_11
      - `segment-12` boolean: segment_12
      - `segment-13` boolean: segment_13
      - `segment-14` boolean: segment_14
      - `segment-15` boolean: segment_15
      - `segment-16` boolean: segment_16
      - `segment-17` boolean: segment_17
      - `segment-18` boolean: segment_18
      - `segment-19` boolean: segment_19
      - `segment-2` boolean: segment_2
      - `segment-20` boolean: segment_20
      - `segment-3` boolean: segment_3
      - `segment-4` boolean: segment_4
      - `segment-5` boolean: segment_5
      - `segment-6` boolean: segment_6
      - `segment-7` boolean: segment_7
      - `segment-8` boolean: segment_8
      - `segment-9` boolean: segment_9
      - `start-date` string, datetime, required: start_date
      - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `updated-by` UserSimple
        - `avatar-thumb-url` string, string: Avatar url
        - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
        - `email` string, string(255), required: email
        - `employee-number` string, string(255): employee number
        - `firstname` string, string(40), required: first name
        - `fullname` string, string(255): full name
        - `id` integer: Coupa unique identifier
        - `lastname` string, string(40), required: last name
        - `login` string, string(255), required: login
        - `salesforce-id` string, string(255), required: salesforce_id
        - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `remaining` number: remaining
    - `remaining-budget` number: Remaining Budget
    - `segment-1` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-10` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-11` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-12` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-13` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-14` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-15` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-16` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-17` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-18` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-19` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-2` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-20` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-3` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-4` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-5` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-6` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-7` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-8` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-9` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `updated-by` UserSimple
      - `avatar-thumb-url` string, string: Avatar url
      - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `email` string, string(255), required: email
      - `employee-number` string, string(255): employee number
      - `firstname` string, string(40), required: first name
      - `fullname` string, string(255): full name
      - `id` integer: Coupa unique identifier
      - `lastname` string, string(40), required: last name
      - `login` string, string(255), required: login
      - `salesforce-id` string, string(255), required: salesforce_id
      - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `budget-remaining` number: budget_remaining
  - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `created-by` UserSimple
    - `avatar-thumb-url` string, string: Avatar url
    - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `email` string, string(255), required: email
    - `employee-number` string, string(255): employee number
    - `firstname` string, string(40), required: first name
    - `fullname` string, string(255): full name
    - `id` integer: Coupa unique identifier
    - `lastname` string, string(40), required: last name
    - `login` string, string(255), required: login
    - `salesforce-id` string, string(255), required: salesforce_id
    - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `currency` Currency
    - `code` string, string(6), required: code
    - `decimals` integer: Decimal precision
    - `enabled` boolean: Enabled
    - `id` integer: Coupa unique identifier
    - `name` string, string(100), required: name
    - `symbol` string, string(10): symbol
  - `description` string, string(255): description
  - `id` integer: Coupa unique identifier
  - `price` number: price
  - `quantity` number: quantity
  - `reason` string, string(255): reason

## Response `201`

Created

- BudgetLineAdjustment
  - `accounting-total` number: accounting_total
  - `adjuster` unknown
  - `adjustment-amount` number: amount
  - `amount` number: amount
  - `budget-line` BudgetLine, required
    - `amount` number: amount
    - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `created-by` UserSimple
      - `avatar-thumb-url` string, string: Avatar url
      - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `email` string, string(255), required: email
      - `employee-number` string, string(255): employee number
      - `firstname` string, string(40), required: first name
      - `fullname` string, string(255): full name
      - `id` integer: Coupa unique identifier
      - `lastname` string, string(40), required: last name
      - `login` string, string(255), required: login
      - `salesforce-id` string, string(255), required: salesforce_id
      - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `currency` Currency
      - `code` string, string(6), required: code
      - `decimals` integer: Decimal precision
      - `enabled` boolean: Enabled
      - `id` integer: Coupa unique identifier
      - `name` string, string(100), required: name
      - `symbol` string, string(10): symbol
    - `description` string, string(255): description
    - `error-on-overrun` boolean: Prevent submission of requisitions that would exceed the budget
    - `id` integer: Coupa unique identifier
    - `notes` string, text: notes
    - `overrun-calculation` integer: Overrun Calculation
    - `owner` UserSimple
      - `avatar-thumb-url` string, string: Avatar url
      - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `email` string, string(255), required: email
      - `employee-number` string, string(255): employee number
      - `firstname` string, string(40), required: first name
      - `fullname` string, string(255): full name
      - `id` integer: Coupa unique identifier
      - `lastname` string, string(40), required: last name
      - `login` string, string(255), required: login
      - `salesforce-id` string, string(255), required: salesforce_id
      - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `owner-is-approver` integer: Owner is approver?
    - `pending-requisitions-amount` number: Amount consumed by pending requisitions
    - `period` Period, required
      - `account-type` AccountType
        - `active` boolean: A false value will inactivate the chart of account making it no longer available to users. A true value will make it active and available to users.
        - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
        - `created-by` UserSimple
          - `avatar-thumb-url` string, string: Avatar url
          - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `email` string, string(255), required: email
          - `employee-number` string, string(255): employee number
          - `firstname` string, string(40), required: first name
          - `fullname` string, string(255): full name
          - `id` integer: Coupa unique identifier
          - `lastname` string, string(40), required: last name
          - `login` string, string(255), required: login
          - `salesforce-id` string, string(255), required: salesforce_id
          - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
        - `currency` Currency, required
          - `code` string, string(6), required: code
          - `decimals` integer: Decimal precision
          - `enabled` boolean: Enabled
          - `id` integer: Coupa unique identifier
          - `name` string, string(100), required: name
          - `symbol` string, string(10): symbol
        - `dynamic-flag` boolean: Boolean value for determing if account type is dynamic
        - `id` integer: Coupa unique identifier
        - `legal-entity-name` string, string: Legal entity or entities that are associated with this chart of accounts
        - `name` string, string(50), required: name
        - `primary-address` Address
          - `active` boolean: A no value will make the address inactive making it no longer available to users. A yes value will make it active and available to users.
          - `attention` string, string(255): Address Default Attention Line
          - `business-group-name` string, string: Content Group Name for Address
          - `city` string, string(255), required: City Name
          - `content-groups` BusinessGroup[]
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `created-by` UserSimple
              - …
            - `description` string, string(255): description
            - `id` integer: Coupa unique identifier
            - `name` string, string(100), required: name
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `updated-by` UserSimple
              - …
          - `country` Country, required
            - `code` string, string(4), required: code
            - `created-at` string: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `id` integer: Coupa unique identifier
            - `name` string, string(100): name
            - `updated-at` string: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `created-by` UserSimple
            - `avatar-thumb-url` string, string: Avatar url
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `email` string, string(255), required: email
            - `employee-number` string, string(255): employee number
            - `firstname` string, string(40), required: first name
            - `fullname` string, string(255): full name
            - `id` integer: Coupa unique identifier
            - `lastname` string, string(40), required: last name
            - `login` string, string(255), required: login
            - `salesforce-id` string, string(255), required: salesforce_id
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `id` integer: Coupa Internal Address ID
          - `local-tax-number` string, string(255), required: Local Tax Number
          - `location-code` string, string(255): location_code
          - `name` string, string(255): Address 'Nickname'
          - `postal-code` string, string(255), required: Postal Code
          - `purposes` Purpose[]
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `created-by` UserSimple
              - …
            - `id` integer: Coupa unique identifier
            - `kind` string, string(255), required: Kind
            - `name` string, string(255), required: Name
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `updated-by` UserSimple
              - …
          - `state` string, string(255): State Name for Address
          - `state-iso-code` string, string(255): ISO Code for the State
          - `street1` string, string(255), required: Address Line 1
          - `street2` string, string(255): Address Line 2
          - `street3` string, string(255): Address Line 3
          - `street4` string, string(255): Address Line 4
          - `tax-registrations` Address[]
          - `type` string, string(255): Address type
          - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `updated-by` UserSimple
            - `avatar-thumb-url` string, string: Avatar url
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `email` string, string(255), required: email
            - `employee-number` string, string(255): employee number
            - `firstname` string, string(40), required: first name
            - `fullname` string, string(255): full name
            - `id` integer: Coupa unique identifier
            - `lastname` string, string(40), required: last name
            - `login` string, string(255), required: login
            - `salesforce-id` string, string(255), required: salesforce_id
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `vat-country` Country
            - `code` string, string(4), required: code
            - `created-at` string: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `id` integer: Coupa unique identifier
            - `name` string, string(100): name
            - `updated-at` string: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `vat-number` string, string(255): VAT identification number used for value added tax purposes
        - `primary-contact` Contact
          - `active` boolean: Active
          - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `created-by` UserSimple
            - `avatar-thumb-url` string, string: Avatar url
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `email` string, string(255), required: email
            - `employee-number` string, string(255): employee number
            - `firstname` string, string(40), required: first name
            - `fullname` string, string(255): full name
            - `id` integer: Coupa unique identifier
            - `lastname` string, string(40), required: last name
            - `login` string, string(255), required: login
            - `salesforce-id` string, string(255), required: salesforce_id
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `email` string, string(255): email
          - `id` integer: Coupa unique identifier
          - `name-additional` string, string(255): name_additional
          - `name-family` string, string(255): name_family
          - `name-fullname` string, string(255): name_fullname
          - `name-given` string, string(255): name_given
          - `name-prefix` string, string(255): name_prefix
          - `name-suffix` string, string(255): name_suffix
          - `notes` string, text: notes
          - `phone-fax` PhoneNumber
            - `area-code` string, string(255): area_code
            - `country-code` string, string(255): country_code
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `created-by` UserSimple
              - …
            - `extension` string, string(255): extension
            - `id` integer: Coupa unique identifier
            - `number` string, string(255): number
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `updated-by` UserSimple
              - …
          - `phone-mobile` PhoneNumber
            - `area-code` string, string(255): area_code
            - `country-code` string, string(255): country_code
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `created-by` UserSimple
              - …
            - `extension` string, string(255): extension
            - `id` integer: Coupa unique identifier
            - `number` string, string(255): number
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `updated-by` UserSimple
              - …
          - `phone-work` PhoneNumber
            - `area-code` string, string(255): area_code
            - `country-code` string, string(255): country_code
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `created-by` UserSimple
              - …
            - `extension` string, string(255): extension
            - `id` integer: Coupa unique identifier
            - `number` string, string(255): number
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `updated-by` UserSimple
              - …
          - `photo` string, string(255): photo
          - `purposes` Purpose[]
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `created-by` UserSimple
              - …
            - `id` integer: Coupa unique identifier
            - `kind` string, string(255), required: Kind
            - `name` string, string(255), required: Name
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `updated-by` UserSimple
              - …
          - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `updated-by` UserSimple
            - `avatar-thumb-url` string, string: Avatar url
            - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
            - `email` string, string(255), required: email
            - `employee-number` string, string(255): employee number
            - `firstname` string, string(40), required: first name
            - `fullname` string, string(255): full name
            - `id` integer: Coupa unique identifier
            - `lastname` string, string(40), required: last name
            - `login` string, string(255), required: login
            - `salesforce-id` string, string(255), required: salesforce_id
            - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
        - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
        - `updated-by` UserSimple
          - `avatar-thumb-url` string, string: Avatar url
          - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
          - `email` string, string(255), required: email
          - `employee-number` string, string(255): employee number
          - `firstname` string, string(40), required: first name
          - `fullname` string, string(255): full name
          - `id` integer: Coupa unique identifier
          - `lastname` string, string(40), required: last name
          - `login` string, string(255), required: login
          - `salesforce-id` string, string(255), required: salesforce_id
          - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `created-by` UserSimple
        - `avatar-thumb-url` string, string: Avatar url
        - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
        - `email` string, string(255), required: email
        - `employee-number` string, string(255): employee number
        - `firstname` string, string(40), required: first name
        - `fullname` string, string(255): full name
        - `id` integer: Coupa unique identifier
        - `lastname` string, string(40), required: last name
        - `login` string, string(255), required: login
        - `salesforce-id` string, string(255), required: salesforce_id
        - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `end-date` string, datetime, required: end_date
      - `id` integer: Coupa unique identifier
      - `is-open` boolean: is_open
      - `name` string, string(100), required: name
      - `segment-1` boolean: segment_1
      - `segment-10` boolean: segment_10
      - `segment-11` boolean: segment_11
      - `segment-12` boolean: segment_12
      - `segment-13` boolean: segment_13
      - `segment-14` boolean: segment_14
      - `segment-15` boolean: segment_15
      - `segment-16` boolean: segment_16
      - `segment-17` boolean: segment_17
      - `segment-18` boolean: segment_18
      - `segment-19` boolean: segment_19
      - `segment-2` boolean: segment_2
      - `segment-20` boolean: segment_20
      - `segment-3` boolean: segment_3
      - `segment-4` boolean: segment_4
      - `segment-5` boolean: segment_5
      - `segment-6` boolean: segment_6
      - `segment-7` boolean: segment_7
      - `segment-8` boolean: segment_8
      - `segment-9` boolean: segment_9
      - `start-date` string, datetime, required: start_date
      - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `updated-by` UserSimple
        - `avatar-thumb-url` string, string: Avatar url
        - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
        - `email` string, string(255), required: email
        - `employee-number` string, string(255): employee number
        - `firstname` string, string(40), required: first name
        - `fullname` string, string(255): full name
        - `id` integer: Coupa unique identifier
        - `lastname` string, string(40), required: last name
        - `login` string, string(255), required: login
        - `salesforce-id` string, string(255), required: salesforce_id
        - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `remaining` number: remaining
    - `remaining-budget` number: Remaining Budget
    - `segment-1` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-10` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-11` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-12` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-13` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-14` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-15` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-16` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-17` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-18` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-19` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-2` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-20` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-3` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-4` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-5` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-6` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-7` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-8` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `segment-9` string, string(100): Optionally provide each segment individually.This is required if any of segments contains the dash "-" character, which prevents the Budgeting Segment code from being split automatically
    - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `updated-by` UserSimple
      - `avatar-thumb-url` string, string: Avatar url
      - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `email` string, string(255), required: email
      - `employee-number` string, string(255): employee number
      - `firstname` string, string(40), required: first name
      - `fullname` string, string(255): full name
      - `id` integer: Coupa unique identifier
      - `lastname` string, string(40), required: last name
      - `login` string, string(255), required: login
      - `salesforce-id` string, string(255), required: salesforce_id
      - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `budget-remaining` number: budget_remaining
  - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `created-by` UserSimple
    - `avatar-thumb-url` string, string: Avatar url
    - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `email` string, string(255), required: email
    - `employee-number` string, string(255): employee number
    - `firstname` string, string(40), required: first name
    - `fullname` string, string(255): full name
    - `id` integer: Coupa unique identifier
    - `lastname` string, string(40), required: last name
    - `login` string, string(255), required: login
    - `salesforce-id` string, string(255), required: salesforce_id
    - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `currency` Currency
    - `code` string, string(6), required: code
    - `decimals` integer: Decimal precision
    - `enabled` boolean: Enabled
    - `id` integer: Coupa unique identifier
    - `name` string, string(100), required: name
    - `symbol` string, string(10): symbol
  - `description` string, string(255): description
  - `id` integer: Coupa unique identifier
  - `price` number: price
  - `quantity` number: quantity
  - `reason` string, string(255): reason

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/coupa/apis/coupa-api-4.md) - [All operations](https://skmtc.dev/coupa/apis/coupa-api-4/llms.txt) - [OpenAPI document](https://skmtc.dev/coupa/apis/coupa-api-4/revisions/adc09cabd758?raw)