Get list of Orders of a Project

GET /v2/projects/{projectId}/orders/

API version

v2

Request method

GET

Operation ID

order-list-project-orders

---

The list of Order of a Project the User has access to, can be filtered by orderStatus, articleTemplate and count.

Request

• projectIdstring (uuid)

  required
  Example:"e7c4b2e6-e38f-4c9b-8583-08bd627ff4d8"

Responses

Format

application/json

Description

Schema documentation

• Array[
• *object
  • contractChangeContractIdstring (uuid)
  • customerIdstring (≥ 1 characters)

    required
  • dueDatestring (date-time)
  • invoicingPeriodnumber

    required

    Invoicing period in months

  • itemsarray of object

    required
    • Array[
    • *object
      • addonsarray of object
        • Array[
        • *object
          • hiddenboolean
          • keystring

            required
          • valuestring

            required
        ]
    • articleIdstring

      required
    • articleNamestring
    • articleTemplateNamestring
    • attributeConfigurationarray of object
      • Array[
      • *object
        • keystring

          required
        • valuestring
      ]
  • isInclusiveboolean

    required
  • orderItemIdstring (uuid)

    required
  • predefinedDomainAggregateIdstring
  • pricenumber

    required
  • referenceobject
    • contractItemIdstring (uuid)
    • offerItemIdstring (uuid)
    • orderItemIdstring (uuid)
]

orderDatestring (date-time)

orderIdstring (uuid)

required

orderNumberstring (≥ 1 characters)

required

profileobject

• emailstring (email)

  required
• first_namestring
• last_namestring
• titlestring (one of: other, mr, ms)

  the users title

• userIdstring (uuid)

  required

statusstring (one of: NEW, CONFIRMED, REJECTED, ABORTED, EXECUTED)

required

summaryobject

required

• nonRecurringnumber

  required
• recurringnumber

  required
• summarynumber

  required

  The total price of the order

typestring (one of: NEW_ORDER, CONTRACT_CHANGE)

required

]

Example

[
  {
    "contractChangeContractId": "f0f86186-0a5a-45b2-aa33-502777496347",
    "customerId": "4317f5c5-1ea8-4084-a9f1-3a8e7e1c94ff",
    "dueDate": "2024-09-16T00:26:44.209Z",
    "invoicingPeriod": 12,
    "items": [
      {
        "addons": [
          {
            "hidden": true,
            "key": "string",
            "value": "string"
          }
        ],
        "articleId": "PS23-PLUS-0004",
        "articleName": "proSpace",
        "articleTemplateName": "Pro-Space-Hosting",
        "attributeConfiguration": [
          {
            "key": "storage",
            "value": 10
          }
        ],
        "isInclusive": true,
        "orderItemId": "f0f86186-0a5a-45b2-aa33-502777496347",
        "predefinedDomainAggregateId": "aa38d836-fe72-4c43-aad3-9472b51edf61",
        "price": 1000,
        "reference": {
          "contractItemId": "f0f86186-0a5a-45b2-aa33-502777496347",
          "offerItemId": "f0f86186-0a5a-45b2-aa33-502777496347",
          "orderItemId": "f0f86186-0a5a-45b2-aa33-502777496347"
        }
      }
    ],
    "orderDate": "2024-09-16T00:26:44.209Z",
    "orderId": "f0f86186-0a5a-45b2-aa33-502777496347",
    "orderNumber": "5XXXXXX",
    "profile": {
      "email": "email@mittwald.example",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "title": "other",
      "userId": "f0f86186-0a5a-45b2-aa33-502777496347"
    },
    "status": "NEW",
    "summary": {
      "nonRecurring": 1000,
      "recurring": 9000,
      "summary": 10000
    },
    "type": "NEW_ORDER"
  }
]

JSON Schema

{
  "items": {
    "properties": {
      "contractChangeContractId": {
        "format": "uuid",
        "type": "string"
      },
      "customerId": {
        "example": "4317f5c5-1ea8-4084-a9f1-3a8e7e1c94ff",
        "minLength": 1,
        "type": "string"
      },
      "dueDate": {
        "format": "date-time",
        "type": "string"
      },
      "invoicingPeriod": {
        "description": "Invoicing period in months",
        "example": 12,
        "type": "number"
      },
      "items": {
        "items": {
          "properties": {
            "addons": {
              "items": {
                "properties": {
                  "hidden": {
                    "type": "boolean"
                  },
                  "key": {
                    "type": "string"
                  },
                  "value": {
                    "type": "string"
                  }
                },
                "required": [
                  "key",
                  "value"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "articleId": {
              "example": "PS23-PLUS-0004",
              "type": "string"
            },
            "articleName": {
              "example": "proSpace",
              "type": "string"
            },
            "articleTemplateName": {
              "example": "Pro-Space-Hosting",
              "type": "string"
            },
            "attributeConfiguration": {
              "items": {
                "properties": {
                  "key": {
                    "example": "storage",
                    "type": "string"
                  },
                  "value": {
                    "example": 10,
                    "type": "string"
                  }
                },
                "required": [
                  "key"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "isInclusive": {
              "type": "boolean"
            },
            "orderItemId": {
              "format": "uuid",
              "type": "string"
            },
            "predefinedDomainAggregateId": {
              "example": "aa38d836-fe72-4c43-aad3-9472b51edf61",
              "type": "string"
            },
            "price": {
              "example": 1000,
              "type": "number"
            },
            "reference": {
              "properties": {
                "contractItemId": {
                  "format": "uuid",
                  "type": "string"
                },
                "offerItemId": {
                  "format": "uuid",
                  "type": "string"
                },
                "orderItemId": {
                  "format": "uuid",
                  "type": "string"
                }
              },
              "type": "object"
            }
          },
          "required": [
            "orderItemId",
            "articleId",
            "price",
            "isInclusive"
          ],
          "type": "object"
        },
        "type": "array"
      },
      "orderDate": {
        "format": "date-time",
        "type": "string"
      },
      "orderId": {
        "format": "uuid",
        "type": "string"
      },
      "orderNumber": {
        "example": "5XXXXXX",
        "minLength": 1,
        "type": "string"
      },
      "profile": {
        "properties": {
          "email": {
            "format": "email",
            "type": "string"
          },
          "first_name": {
            "example": "Ada",
            "type": "string"
          },
          "last_name": {
            "example": "Lovelace",
            "type": "string"
          },
          "title": {
            "description": "the users title",
            "enum": [
              "other",
              "mr",
              "ms"
            ],
            "type": "string"
          },
          "userId": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "userId",
          "email"
        ],
        "type": "object"
      },
      "status": {
        "enum": [
          "NEW",
          "CONFIRMED",
          "REJECTED",
          "ABORTED",
          "EXECUTED"
        ],
        "type": "string"
      },
      "summary": {
        "properties": {
          "nonRecurring": {
            "example": 1000,
            "type": "number"
          },
          "recurring": {
            "example": 9000,
            "type": "number"
          },
          "summary": {
            "description": "The total price of the order",
            "example": 10000,
            "type": "number"
          }
        },
        "required": [
          "summary",
          "recurring",
          "nonRecurring"
        ],
        "type": "object"
      },
      "type": {
        "enum": [
          "NEW_ORDER",
          "CONTRACT_CHANGE"
        ],
        "type": "string"
      }
    },
    "required": [
      "orderId",
      "orderNumber",
      "summary",
      "customerId",
      "invoicingPeriod",
      "type",
      "status",
      "items"
    ],
    "type": "object"
  },
  "type": "array"
}

Usage examples

cURL

$ curl \
    --fail \
    --location \
    -H "Authorization: Bearer $MITTWALD_API_TOKEN" \
    https://api.mittwald.de/v2/projects/f0f86186-0a5a-45b2-aa33-502777496347/orders?limit=50&page=1&includesStatus=NEW&excludesStatus=NEW&templateNames=string

JavaScript SDK

import { MittwaldAPIV2Client } from "@mittwald/api-client";
import { assertStatus } from "@mittwald/api-client-commons";
  
const client = MittwaldAPIClient.newWithToken(process.env.MITTWALD_API_TOKEN);
const response = await client.contract.orderListProjectOrders({
  "projectId": "f0f86186-0a5a-45b2-aa33-502777496347",
  "queryParameters": {
    "limit": 50,
    "page": 1,
    "includesStatus": [
      "NEW"
    ],
    "excludesStatus": [
      "NEW"
    ],
    "templateNames": [
      "string"
    ]
  }
});

assertStatus(response, 200);
  

PHP SDK

use \Mittwald\ApiClient\Generated\V2\Clients\Contract\OrderListProjectOrders\OrderListProjectOrdersRequest;
  
$client = MittwaldAPIClient::newWithToken(getenv('MITTWALD_API_TOKEN'));

$request = (new OrderListProjectOrdersRequest(
  projectId: "f0f86186-0a5a-45b2-aa33-502777496347"
))
  ->withLimit(50)
  ->withPage(1)
  ->withIncludesStatus(["NEW"])
  ->withExcludesStatus(["NEW"])
  ->withTemplateNames(["string"]);
$response = $client->contract()->orderListProjectOrders($request);

var_dump($response->getBody();