Skip to content

Get purchase order

Request

Returns one stored purchase order, exactly as it was accepted.

Security
OAuth2(Required scopes: enrichment.read)
Path
externalIdstringrequired

Previously sent externalId

curl -i -X GET \
  'https://api.cloud.hypatos.ai/v2/enrichment/purchase-orders/{externalId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

The stored purchase order

Bodyapplication/json
metadataobject(recordMetadata)required
dataobject(purchaseOrder)required

The stored resource, exactly as it was accepted.

Response
{ "metadata": { "createdAt": "2026-10-01T09:12:44.123456Z", "updatedAt": "2026-10-03T15:02:10.654321Z" }, "data": { "externalId": "4500016221", "externalClientId": "EXTERNAL_CLIENT_ID", "purchaseOrderNumber": "PoNumber123", "createdDate": "2000-12-31", "fiscalYearLabel": "2023", "language": "string", "externalCompanyId": "DE01", "type": "Service", "externalSupplierId": "0000100000", "status": "OPEN", "invoicingStatus": "partial", "deliveryStatus": "partial", "currency": "EUR", "totalNetAmount": 81, "totalFreightCharges": 9, "totalOtherCharges": 10, "totalTaxAmount": 19, "totalGrossAmount": 119, "totalInvoicedNetAmount": 119, "paymentTerms": { … }, "customFields": { … }, "customMetadata": { … }, "purchaseOrderLines": [ … ], "productNumber": "123456789", "externalPurchaserId": "PUR-88293-X", "deliveryTerms": { … } } }