> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Receive Purchase Order

> This endpoint records receipt of a purchase order.

### Path parameters

<ParamField path="id" type="string" required>
  The unique identifier of the purchase order.
</ParamField>

### Body

<ParamField body="purchase_order_id" type="string">
  Your own identifier for this purchase order, if you track one.
</ParamField>

<ParamField body="properties" type="object">
  A JSON object of custom properties stored against the purchase order.
</ParamField>

### Response

<ResponseField name="success" type="number">
  Indicates whether the call was successful. 1 if successful, 0 if not.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request POST 'https://api.stateset.com/v1/purchase_orders/:id/receive' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Token <token>' \
  --data-raw '{
      "purchase_order_id": "example_1"
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": 1
  }
  ```
</ResponseExample>