For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
Resources
Log inGet a demo
Get startedAPI referenceImplementation
Get startedAPI referenceImplementation
    • Overview
          • The PurchaseOrder object
          • GET/purchase-orders
          • POST/purchase-orders
          • GET/purchase-orders/{id}
          • GET/purchase-orders/line-items/remote-field-classes
          • GET/purchase-orders/meta/post
          • GET/purchase-orders/remote-field-classes

Get started

  • Overview
  • Introduction
  • Unified API
  • Linked Account
  • Merge Link
  • Use cases

Implementation

  • Sandboxes
  • SDKs
  • API access
  • Syncing data
  • Writing data
  • Data minimization
  • Supplemental data
  • Errors
  • Integration metadata

API reference

  • ATS
  • HRIS
  • Accounting
  • Ticketing
  • CRM
  • File Storage
  • Knowledge Base
  • Chat

Resources

  • Help Center
  • Merge.dev
  • Changelog
© Merge 2026Terms of usePrivacy policy
UnifiedAgent HandlerGateway
UnifiedAgent HandlerGateway
Resources
Log inGet a demo
Common ModelsPurchase Orders

The PurchaseOrder object

The PurchaseOrder Object
1{
2  "id": "string",
3  "remote_id": "string",
4  "created_at": "2023-01-01T00:00:00Z",
5  "modified_at": "2023-01-01T00:00:00Z",
6  "status": "DRAFT",
7  "issue_date": "2023-01-01T00:00:00Z",
8  "purchase_order_number": "string",
9  "delivery_date": "2023-01-01T00:00:00Z",
10  "delivery_address": "string",
11  "customer": "string",
12  "vendor": "string",
13  "memo": "string",
14  "company": "string",
15  "total_amount": 1,
16  "currency": "XUA",
17  "exchange_rate": "string",
18  "payment_term": "string",
19  "line_items": [
20    {
21      "id": "string",
22      "remote_id": "string",
23      "created_at": "2023-01-01T00:00:00Z",
24      "modified_at": "2023-01-01T00:00:00Z",
25      "description": "string",
26      "unit_price": 1,
27      "quantity": 1,
28      "item": "string",
29      "account": "string",
30      "tracking_category": "string",
31      "tracking_categories": [
32        "string"
33      ],
34      "tax_amount": "string",
35      "total_line_amount": "string",
36      "currency": "XUA",
37      "tax_rate": "string",
38      "exchange_rate": "string",
39      "company": "string",
40      "remote_was_deleted": true,
41      "remote_fields": [
42        {
43          "remote_field_class": {
44            "id": "string",
45            "display_name": "string",
46            "remote_key_name": "string",
47            "description": "string",
48            "is_custom": true,
49            "is_common_model_field": true,
50            "is_required": true,
51            "field_type": "string",
52            "field_format": "string",
53            "field_choices": [
54              "string"
55            ],
56            "item_schema": {
57              "item_type": "string",
58              "item_format": "string",
59              "item_choices": [
60                "string"
61              ]
62            }
63          },
64          "value": {
65            "string": {}
66          }
67        }
68      ]
69    }
70  ],
71  "inclusive_of_tax": true,
72  "tracking_categories": [
73    "string"
74  ],
75  "accounting_period": "string",
76  "remote_created_at": "2023-01-01T00:00:00Z",
77  "remote_updated_at": "2023-01-01T00:00:00Z",
78  "remote_was_deleted": true,
79  "field_mappings": {
80    "organization_defined_targets": {
81      "string": {}
82    },
83    "linked_account_defined_targets": {
84      "string": {}
85    }
86  },
87  "remote_data": [
88    {
89      "path": "string",
90      "data": {}
91    }
92  ],
93  "remote_fields": [
94    {
95      "remote_field_class": {
96        "id": "string",
97        "display_name": "string",
98        "remote_key_name": "string",
99        "description": "string",
100        "is_custom": true,
101        "is_common_model_field": true,
102        "is_required": true,
103        "field_type": "string",
104        "field_format": "string",
105        "field_choices": [
106          "string"
107        ],
108        "item_schema": {
109          "item_type": "string",
110          "item_format": "string",
111          "item_choices": [
112            "string"
113          ]
114        }
115      },
116      "value": {
117        "string": {}
118      }
119    }
120  ]
121}
Was this page helpful?
Previous

/projects/{id}

Next

/purchase-orders

A PurchaseOrder represents a request to purchase goods or services from a vendor. It outlines the details of the purchase, such as the items or services requested, quantities, prices, and delivery details.

A PurchaseOrder is a crucial component of the procurement process, but does not typically result in any impact on the company’s general ledger. The general ledger is typically only affected when the PurchaseOrder is fulfilled as an Accounts Payable Invoice object (also known as a Bill).

idstringOptionalRead-onlyformat: "uuid"
remote_idstring or nullOptional
created_atdatetimeOptionalRead-only
The datetime that this object was created by Merge.
modified_atdatetimeOptionalRead-only
The datetime that this object was modified by Merge.
statusenum or nullOptional
The purchase order's status.
Allowed values:
issue_datedatetime or nullOptional
The purchase order's issue date.
purchase_order_numberstring or nullOptional<=100 characters
delivery_datedatetime or nullOptional
The purchase order's delivery date.
delivery_addressstring or nullOptionalformat: "uuid"
The purchase order's delivery address.
customerstring or nullOptionalformat: "uuid"
The contact making the purchase order.
vendorstring or nullOptionalformat: "uuid"
The party fulfilling the purchase order.
memostring or nullOptional
A memo attached to the purchase order.
companystring or nullOptionalformat: "uuid"
The company the purchase order belongs to.
total_amountdouble or nullOptional
The purchase order's total amount.
currencyenum or nullOptional
The purchase order's currency. The currency code in ISO 4217 format.
exchange_ratestring or nullOptionalformat: "decimal"
The purchase order's exchange rate.
payment_termstring or nullOptionalformat: "uuid"
The payment term that applies to this transaction.
line_itemslist of objectsOptionalRead-only
inclusive_of_taxboolean or nullOptional
tracking_categorieslist of stringsOptional
accounting_periodstring or nullOptionalformat: "uuid"
The accounting period that the PurchaseOrder was generated in.
remote_created_atdatetime or nullOptional
When the third party's purchase order note was created.
remote_updated_atdatetime or nullOptional
When the third party's purchase order note was updated.
remote_was_deletedbooleanOptionalRead-only
field_mappingsobject or nullOptionalRead-only
remote_datalist of objects or nullOptionalRead-only
remote_fieldslist of objectsOptionalRead-only