--- title: "Get a purchase order" slug: "get-a-purchase-order" updated: 2026-01-30T20:02:42Z published: 2026-02-10T12:53:32Z --- > ## Documentation Index > Fetch the complete documentation index at: https://www.bloxs.io/llms.txt > Use this file to discover all available pages before exploring further. # Get a purchase order Get/api/v1/invoices/purchaseorders Get an existing purchase order. **Description** This endpoint retrieves specific purchase order. **Use Case** The user wants to retrieve a specific purchase order by specifying its reference. To obtain the reference of a particular purchase order, the user can first use the [POST filter](/v1-api/apidocs/get-purchase-invoices-filtered-and-paged)endpoint. Subsequently the reference can be used to retrieve the specifics of this purchase order. **Request****fields** The request contains the following fields: | Field | Description | | --- | --- | | reference | The unique identifier for this purchase order within Bloxs. This identifier is generated by Bloxs. | | externalIdentifier | The unique identifier for this specific purchase order, not created by Bloxs. | **Response fields** In addition to the fields in the request, the 200 response contains the fields in the table below. | Field | Description | | --- | --- | | ownerReference | The reference of the relation that is the buying party in this purchase order. This refers to the reference created by Bloxs, not to be confused with the externalIdentifier. | | relationReference | The reference of the relation that is the selling party in this purchase order (supplier). This reference is created by Bloxs. | | proposalReference | The reference of the proposal which (usually) preceded the purchase order. This reference is created by Bloxs. | | proposalTotalAmountExcl | The total amount excluding VAT in the proposal that preceded the purchase order. | | subject | The subject of the purchase order. | | workflowState | 1 = Draft Concept status. Edits are still possible. 2 = OnHold This means that an purchase order is on hold before it can be approved, for example due to a dispute with the supplier. 3 = Cancelled This purchase order was, for example, not needed or created in error. 4 = ApprovalWorkflow Submitted for approval. For example, the purchase order is pending approval by person X. This may involve a simple or extended approval chain of multiple people. 7 = Final This is the most relevant status for integration partners. Purchase orders are then fully processed (and potentially sent). 9 = Disapproved The purchase order has been returned by an approver for adjustments by the creator. 10 = OwnerApprovalWorkflow Submitted for approval by the owner. The purchase order is then awaiting the owner’s approval via the owners’ portal. This is in addition to the normal approval process but is linked to the use of the owners’ portal. 11 = DisapprovedByOwner Disapproved by the owner. This requires further review. | | finalizationState | The status of payment. 0 = Open 1 = Completed 2 = Closed | | totalAmountExcl | Total amount of the purchase order excluding VAT. | | invoicedAmount | The amount that has been invoiced till today. | | outstandingAmount | The amount that of today has not been invoiced, and is therefore still outstanding. | | lineIndex | The order of this specific line in the purchase order. | | expectedDate | End date of the invoice payments of this specific line in the purchase order. | | description | Description of the specific line in the purchase order. | | ledgerAccountCode | The code of the ledger account of the specific line in the purchase order. | | realEstateObjectReference | This is the reference of the realestate object of the specific line in the purchase order. This refers to the reference created by Bloxs, not to be confused with the externalIdentifier. | | taxRateCode | The code of the tax rate (including the percentage) of the specific line in the purchase order. | | amountExcl | The amount excluding VAT of the specific line in the purchase order. | SecurityHTTPType Bearer Please enter a valid token Query parametersreferencestring The internal identifier of the model (i.e. Reference, Code, Name, depends on model). externalIdentifierstring The external API identifier of the model. Responses200 OK Expand Allobject referencestring Min length0Max length100 externalIdentifierstring Min length0Max length100 ownerReferencestring Min length0Max length100 relationReferencestring Min length0Max length100 proposalReferencestring Min length0Max length100 proposalTotalAmountExclnumber (double) | null subjectstring | null Min length0Max length512 workflowStateinteger (int32) Valid values[ 1, 2, 3, 4, 7, 9, 10, 11 ] finalizationStateinteger (int32) Valid values[ 0, 1, 2 ] totalAmountExclnumber (double) invoicedAmountnumber (double) | null outstandingAmountnumber (double) | null lines Array of object (PurchaseOrderLineAPIModel) | null object lineIndexinteger (int32) expectedDatestring (date) descriptionstring | null Min length0Max length512 ledgerAccountCodestring | null Min length0Max length12 realEstateObjectReferencestring | null Min length0Max length100 taxRateCodestring | null Min length0Max length12 amountExclnumber (double) 404 The requested purchase order was not found.