<commit_before>---
title: Purchase Request
layout: reference
---

# Purchase Request
* [Create a new purchase request](#post)
* [Get details of purchase request](#get)
* [Schema](#create_purchase_request_schema)
* [Response schema](#create_purchase_request_schema-response)
* [Error codes](#error-codes)


## Version
4.0<br>
**PRE-RELEASE:** The API is in Pre-Release and that only authorized early adopters should be using the API. Please contact <a href="mailto:<EMAIL>"><EMAIL></a> for more information.

## <a name="post"></a>Create a new purchase request  

    POST  /purchaserequest/v4/purchaserequests

Create a Purchase Request based on provided header and line item details. If the request is valid it returns back a unique identifier to look at purchase request details and creates a purchase request in back ground.

### <a name="8"></a>Parameters  

|Name | Type | Format | Description
|-----|------|--------|------------
|`Authorization`|`string`|`header`|**Required**: Bearer Token that identifies the caller. This is the company JWT
|`Content-Type`|`string`|`header`|**Required**: application/json
|`concur-correlationid`|`string`|`header`|A unique correlation id the caller of API can pass to track specific requests if needed
|`purchaseRequest`|`string`|`body`|**Required**: The details of the purchase request


### Input  

[Schema](#create_purchase_request_schema)

- Example  Input <br>
  **Note:** This is just a sample set of fields. The fields and values needing to be passed for your entity will vary based on your edition of concur and your forms and fields setup, but should include most of these common fields.

```shell
POST /purchaserequest/v4/purchaserequests
Authorization: Bearer {token}
Content-Type: application/json
```


  ```shell
  {
      "description" : "New office supplies",
      "userLoginId" : "<EMAIL>.deo@concur",
      "policyExternalId" : "po-external-id",
      "currencyCode" : "USD",
      "notesToSupplier" : "Office space request phase 1",
      "comments" : "office supplies request",
      "custom1" : "ADVT",

      "lineItems" : [
          {
              "purchaseType" : "SERVICES",
              "vendorCode" :"VEN1",
              "vendorAddressCode" : "ADDR1",
              "description" : "monitor",
              "quantity" : "20",
              "unitPrice" : "154.4",
              "receiptType" : "QUANTITY_RECEIPT",
              "neededByDate": "2018-06-28",
              "uomCode" : "DA",
              "shipping" : "13.5",
              "tax" : "11",
              "supplierPartId" : "DAQT1",
              "url" :[
                  "http://officesupplies.com/monitor"
              ],
              "notesToVendor" : "Phase 1 request monitor",
              "comments" : "Phase 1 request for new employees for monitor",<commit_msg>Changed shell to json<commit_after>---
title: Purchase Request
layout: reference
---

# Purchase Request
* [Create a new purchase request](#post)
* [Get details of purchase request](#get)
* [Schema](#create_purchase_request_schema)
* [Response schema](#create_purchase_request_schema-response)
* [Error codes](#error-codes)


## Version
4.0<br>
**PRE-RELEASE:** The API is in Pre-Release and that only authorized early adopters should be using the API. Please contact <a href="mailto:<EMAIL>"><EMAIL></a> for more information.

## <a name="post"></a>Create a new purchase request  

    POST  /purchaserequest/v4/purchaserequests

Create a Purchase Request based on provided header and line item details. If the request is valid it returns back a unique identifier to look at purchase request details and creates a purchase request in back ground.

### <a name="8"></a>Parameters  

|Name | Type | Format | Description
|-----|------|--------|------------
|`Authorization`|`string`|`header`|**Required**: Bearer Token that identifies the caller. This is the company JWT
|`Content-Type`|`string`|`header`|**Required**: application/json
|`concur-correlationid`|`string`|`header`|A unique correlation id the caller of API can pass to track specific requests if needed
|`purchaseRequest`|`string`|`body`|**Required**: The details of the purchase request


### Input  

[Schema](#create_purchase_request_schema)

- Example  Input <br>
  **Note:** This is just a sample set of fields. The fields and values needing to be passed for your entity will vary based on your edition of concur and your forms and fields setup, but should include most of these common fields.

```shell
POST /purchaserequest/v4/purchaserequests
Authorization: Bearer {token}
Content-Type: application/json
```


  ```json
  {
      "description" : "New office supplies",
      "userLoginId" : "john.deo@concur",
      "policyExternalId" : "po-external-id",
      "currencyCode" : "USD",
      "notesToSupplier" : "Office space request phase 1",
      "comments" : "office supplies request",
      "custom1" : "ADVT",

      "lineItems" : [
          {
              "purchaseType" : "SERVICES",
              "vendorCode" :"VEN1",
              "vendorAddressCode" : "ADDR1",
              "description" : "monitor",
              "quantity" : "20",
              "unitPrice" : "154.4",
              "receiptType" : "QUANTITY_RECEIPT",
              "neededByDate": "2018-06-28",
              "uomCode" : "DA",
              "shipping" : "13.5",
              "tax" : "11",
              "supplierPartId" : "DAQT1",
              "url" :[
                  "http://officesupplies.com/monitor"
              ],
              "notesToVendor" : "Phase 1 request monitor",
              "comments" : "Phase 1 request for new employees for monitor",
{'fraction_non_alphanumeric': 0.13731768054073284, 'fraction_numerical': 0.011028103877623622, 'mean_word_length': 2.971045197740113, 'pattern_counts': {'":': 2, '<': 24, '<?xml version=': 0, '>': 24, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '935937', 'n_tokens_mistral': 1686, 'n_tokens_neox': 1572, 'n_words': 514}