Skip to main content
GET
/
v1
/
purchase-order
Get all purchase orders
curl --request GET \
  --url http://localhost:3001/v1/purchase-order \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "currency": "<string>",
      "counterpartyId": "<string>",
      "counterpartyName": "<string>",
      "totalOrderAmount": 123,
      "totalInvoicedAmount": 123,
      "totalLineItems": 123,
      "fullyInvoicedLineItemsCount": 123,
      "fullyDeliveredLineItemsCount": 123,
      "invoiceCompletionPercentage": 123,
      "totalOrderQuantity": 123,
      "totalDeliveredQuantity": 123,
      "uniqueDeliveriesCount": 123,
      "totalInvoicedQuantity": 123,
      "uniqueInvoicesCount": 123,
      "outstandingInvoiceAmount": 123,
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "purchaseOrderNumber": "<string>",
      "externalId": "<string>",
      "orderDate": "2023-11-07T05:31:56Z",
      "deliveryDate": "2023-11-07T05:31:56Z",
      "counterparty": {
        "email": "<string>",
        "name": "<string>",
        "markedTrusted": true,
        "markedTrustedDate": "2023-11-07T05:31:56Z",
        "markedTrustedUser": {
          "email": "<string>",
          "name": "<string>",
          "authId": "<string>",
          "role": "<string>",
          "hasPushNotification": true,
          "organization": {
            "name": "<string>",
            "slug": "<string>",
            "logoFileName": "<string>",
            "country": "<string>",
            "vatNumber": "<string>",
            "featureFlags": [
              {
                "featureName": "<string>",
                "isEnabled": true,
                "id": "<string>",
                "createdAt": "2023-11-07T05:31:56Z",
                "updatedAt": "2023-11-07T05:31:56Z"
              }
            ],
            "baseCurrency": "EUR",
            "paymentRunBatchBooking": true,
            "paymentRunVerificationOfPayee": true,
            "customExportFormats": [
              "custom_experta"
            ],
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z"
          },
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z"
        },
        "description": "<string>",
        "vat": "<string>",
        "accountsPayableNumber": "22 0391919",
        "street": "<string>",
        "city": "<string>",
        "zip": "<string>",
        "country": "<string>",
        "paymentTermsDays": 123,
        "skontoPercentage": 123,
        "skontoDays": 123,
        "organization": {
          "name": "<string>",
          "slug": "<string>",
          "logoFileName": "<string>",
          "country": "<string>",
          "vatNumber": "<string>",
          "featureFlags": [
            {
              "featureName": "<string>",
              "isEnabled": true,
              "id": "<string>",
              "createdAt": "2023-11-07T05:31:56Z",
              "updatedAt": "2023-11-07T05:31:56Z"
            }
          ],
          "baseCurrency": "EUR",
          "paymentRunBatchBooking": true,
          "paymentRunVerificationOfPayee": true,
          "customExportFormats": [
            "custom_experta"
          ],
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z"
        },
        "bankAccount": {
          "name": "<string>",
          "iban": "<string>",
          "bic": "<string>",
          "countryCode": "<string>",
          "address": "<string>",
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z"
        },
        "bankAccountVerification": {
          "bankAccount": {
            "name": "<string>",
            "iban": "<string>",
            "bic": "<string>",
            "countryCode": "<string>",
            "address": "<string>",
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z"
          },
          "paymentProvider": "<string>",
          "status": "VALID",
          "initializedAt": "2023-11-07T05:31:56Z",
          "mailTrackings": {
            "version": 123,
            "type": "ONBOARDING",
            "status": "ACCEPTED",
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z"
          },
          "fullName": "<string>",
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z"
        },
        "transactions": [
          "<string>"
        ],
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z"
      },
      "lineItems": [
        {
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "productCode": 123,
          "externalId": "<string>",
          "title": "<string>",
          "description": "<string>",
          "quantity": 123,
          "unit": 123,
          "unitPrice": 123,
          "totalPrice": 123,
          "discount": 123,
          "taxRate": 123,
          "taxAmount": 123,
          "deliveredQuantity": 123,
          "invoicedQuantity": 123,
          "invoicedTotalAmount": 123,
          "deliveryPercentage": 123,
          "invoicedPercentage": 123
        }
      ]
    }
  ],
  "meta": {
    "page": 123,
    "take": 123,
    "itemCount": 123,
    "pageCount": 123,
    "hasPreviousPage": true,
    "hasNextPage": true
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
order
enum<string>
default:ASC

Choose between ascending and descending order.

Available options:
ASC,
DESC
​
page
number
default:1

Specify the number of the page you want to retrieve.

Required range: x >= 1
​
take
number
default:10

Specify the number of items you want to retrieve per page.

Required range: 1 <= x <= 100
​
purchaseOrderNumber
string

Filter purchase orders by purchase order number.

​
externalId
string

Filter purchase orders by external ID.

​
counterpartyId
string

Filter purchase orders by counterparty ID.

​
searchTerm
string

Search term to filter by purchase order number or counterparty name.

​
includeAggregations
boolean
default:false

Include aggregated data (totals, counts, percentages). Defaults to false for better performance.

Response

200 - application/json
​
data
object[]
required

Paginated items.

​
meta
object
required

Additional information about the page.