Client APISpend Requisitions

Create a spend requisition

Create a spend requisition. Create a spend requisition for a hirer. Spend requisitions are pre-contract funding requests that flow through approvals. You can include custom fields configured on your client account and optionally set an external ID for idempotency and later lookup. When approval applies, the returned spend requisition includes the approval flow identifier and the current approval step identifier, if a step is currently awaiting action. Note: Spend Requisition was previously named Spend Request. Some programmatic names use the old terminology.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
hirerstringRequired
The identifier or the email address of the hirer creating the spend requisition.
titlestringRequired<=100 characters
The title of the spend requisition.
descriptionstringRequired<=100000 characters
A detailed description of the spend requisition.
amountstringRequiredformat: "decimal"
The amount of money requested.
amount_typeenumRequired

The type of the amount requested.

  • DAY_RATE - Day rate
  • TOTAL - Total
Allowed values:
currencyenumRequired

The currency in which the amount is specified.

  • AUD - $ AUD
  • CAD - $ CAD
  • CHF - ₣ CHF
  • CZK - Kč CZK
  • DKK - kr DKK
  • EUR - € EUR
  • GBP - £ GBP
  • HKD - $ HKD
  • NOK - kr NOK
  • NZD - $ NZD
  • PLN - zł PLN
  • SEK - kr SEK
  • SGD - $ SGD
  • AED - د.إ AED
  • USD - $ USD
  • ZAR - R ZAR
custom_fieldslist of objectsOptional
An array of custom fields specific to the spend requisition.
external_idstringOptionalDefaults to
An external identifier for the spend requisition, optional.
spend_request_configurationstringOptional<=40 charactersDefaults to
The identifier of the configuration to create the spend requisition against.

Response

dataobject

The spend requisition object.

This object represents a request to commit spend on the YunoJuno platform. Spend Requisition was previously named Spend Request in the API documentation; some programmatic names use the old terminology.