Create a spend requisition | YunoJuno API Documentation

curl -X POST https://api.yunojuno.com/spend_requests/ \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "hirer": "string",
  "title": "string",
  "description": "string",
  "amount": "string",
  "amount_type": "DAY_RATE",
  "currency": "AUD"
}'

{
  "data": {
    "spend_request_id": "string",
    "url": "string",
    "external_id": "string",
    "title": "string",
    "description": "string",
    "amount": "string",
    "amount_type": "DAY_RATE",
    "currency": "AUD",
    "custom_fields": [
      {
        "name": "string",
        "value": "string",
        "metadata": null
      }
    ],
    "approval_flow": {
      "approval_flow_id": "string",
      "current_approval_step": {
        "approval_step_id": "string"
      }
    }
  }
}

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.

Note: Spend Requisition was previously named Spend Request. Some programmatic names use the old terminology.

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. 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

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.