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": [
    {
      "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": {
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "email": "<string>",
        "name": "<string>",
        "markedTrusted": true,
        "markedTrustedDate": "2023-11-07T05:31:56Z",
        "markedTrustedUser": {
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "email": "<string>",
          "name": "<string>",
          "authId": "<string>",
          "role": "<string>",
          "hasPushNotification": true,
          "organization": {}
        },
        "description": "<string>",
        "vat": "<string>",
        "accountsPayableNumber": "22 0391919",
        "street": "<string>",
        "city": "<string>",
        "zip": "<string>",
        "country": "<string>",
        "paymentTermsDays": 123,
        "skontoPercentage": 123,
        "skontoDays": 123,
        "organization": {
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "name": "<string>",
          "slug": "<string>",
          "logoFileName": "<string>",
          "country": "<string>",
          "vatNumber": "<string>",
          "featureFlags": [
            {}
          ]
        },
        "bankAccount": {
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "name": "<string>",
          "iban": "<string>",
          "bic": "<string>",
          "countryCode": "<string>",
          "address": "<string>"
        },
        "bankAccountVerification": {
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "bankAccount": {
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "name": "<string>",
            "iban": "<string>",
            "bic": "<string>",
            "countryCode": "<string>",
            "address": "<string>"
          },
          "paymentProvider": "<string>",
          "status": "VALID",
          "initializedAt": "2023-11-07T05:31:56Z",
          "mailTrackings": {
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "version": 123,
            "type": "ONBOARDING",
            "status": "ACCEPTED"
          },
          "fullName": "<string>"
        },
        "transactions": {
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "amount": 123,
          "remittanceInformation": "<string>",
          "requestedExecutionDate": "2023-11-07T05:31:56Z",
          "skontoAmount": 123,
          "skontoDate": "2023-11-07T05:31:56Z",
          "ignoreSkontoDeadline": true,
          "creditor": {
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "name": "<string>",
            "iban": "<string>",
            "bic": "<string>",
            "countryCode": "<string>",
            "address": "<string>"
          },
          "debitor": {
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "name": "<string>",
            "iban": "<string>",
            "bic": "<string>",
            "countryCode": "<string>",
            "address": "<string>"
          },
          "analysis": {
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "analysisRules": {},
            "customRules": {}
          },
          "archived": true,
          "archivedDate": "2023-11-07T05:31:56Z",
          "archivedByUser": {
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "email": "<string>",
            "name": "<string>",
            "authId": "<string>",
            "role": "<string>",
            "hasPushNotification": true,
            "organization": {}
          },
          "paymentRun": {
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "createdById": "<string>",
            "createdByName": "<string>",
            "organizationId": "<string>",
            "sumAmount": 123,
            "sumAmountWithSkonto": 123,
            "sumBookedAmount": 123,
            "transactionCount": 123
          }
        }
      },
      "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
        }
      ],
      "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
    }
  ],
  "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.

Response

200 - application/json
​
data
object[]
required

Paginated items.

​
meta
object
required

Additional information about the page.