---
updatedAt: 2026-05-04T09:40:53.000Z
agentTools:
  projectIndex: https://docs.company.info/llms.txt
---

# Place a new document order

Place a new document order


# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "NL Official Documents API",
    "description": "NL Official Documents API project represents the functionality to order documents from the KVK website.\n",
    "version": "v0.1.0"
  },
  "servers": [
    {
      "url": "https://api.company.info/nl/organizations/official-documents",
      "description": "Production Server"
    }
  ],
  "security": [
    {
      "authToken": []
    },
    {
      "jwtAuth": []
    }
  ],
  "paths": {
    "/v1/orders": {
      "post": {
        "operationId": "createOrder",
        "summary": "Place a new document order",
        "tags": [
          "Order"
        ],
        "description": "Place a new document order\n",
        "requestBody": {
          "description": "The request body",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "data": {
                    "type": "object",
                    "properties": {
                      "type": {
                        "type": "string",
                        "example": "orders"
                      },
                      "attributes": {
                        "$ref": "#/components/schemas/OrderRequestAttributes"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "OK",
            "headers": {
              "X-Correlation-Id": {
                "description": "Unique request identifier",
                "schema": {
                  "type": "string",
                  "format": "uuid"
                }
              }
            },
            "content": {
              "application/vnd.api+json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/OrderResultData"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "authToken": {
        "description": "API Key Authentication",
        "type": "apiKey",
        "in": "header",
        "name": "X-API-KEY"
      },
      "jwtAuth": {
        "description": "JWT Authentication",
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    },
    "schemas": {
      "OrderRequestAttributes": {
        "title": "OrderRequestAttributes",
        "description": "Attributes for placing a new document order. `branchID`, `productName` and\n`productDate` are only used with specific `documentType` values;\nthe server rejects combinations that are not allowed.\n",
        "type": "object",
        "required": [
          "documentType",
          "organizationID"
        ],
        "properties": {
          "documentType": {
            "type": "string",
            "enum": [
              "standardExtract"
            ],
            "example": "standardExtract"
          },
          "organizationID": {
            "type": "string",
            "example": "33302047"
          },
          "branchID": {
            "type": "string",
            "description": "Optional branch number. Not allowed for statute or concernRelations documents.",
            "example": "000016450760"
          },
          "productName": {
            "type": "string",
            "enum": [
              "directRelations",
              "totalConcern",
              "deedOfIncorporation",
              "actOfIncorporation",
              "amendmentOfArticlesOfAssociation",
              "deedOfMerger",
              "rectification",
              "deedOfDivision",
              "mostRecentArticlesOfAssociation",
              "mergerDemergerProposal",
              "demergerDeed",
              "latestArticlesOfAssociation",
              "articlesOfIncorporation",
              "articlesOfAssociation"
            ],
            "description": "Required for `standardStatute`, `manualStatute`, `maskedStatute` and\n`concernRelations`.\n",
            "example": "directRelationships"
          },
          "productDate": {
            "type": "string",
            "description": "Present for `standardStatute`, `maskedStatute` and `annualAccounts` orders. Can be a full date or a year.",
            "oneOf": [
              {
                "type": "string",
                "format": "date",
                "example": "2023-12-06"
              },
              {
                "type": "string",
                "pattern": "^\\d{4}$",
                "example": "2023"
              }
            ]
          }
        }
      },
      "OrderResultData": {
        "title": "Order",
        "type": "object",
        "required": [
          "id",
          "type",
          "attributes"
        ],
        "properties": {
          "id": {
            "type": "string",
            "example": "01HS0SZQECSKQ8NV20391MZ0R1"
          },
          "type": {
            "type": "string",
            "enum": [
              "orders"
            ],
            "example": "orders"
          },
          "attributes": {
            "type": "object",
            "required": [
              "documentType",
              "organizationID",
              "status",
              "createdAt"
            ],
            "properties": {
              "documentType": {
                "type": "string",
                "enum": [
                  "standardExtract"
                ],
                "example": "standardExtract"
              },
              "status": {
                "type": "string",
                "enum": [
                  "pending",
                  "done",
                  "failed",
                  "cancelled"
                ],
                "example": "pending"
              },
              "organizationID": {
                "type": "string",
                "example": "33302047"
              },
              "branchID": {
                "type": "string",
                "description": "Present when the order was placed for a specific branch.",
                "example": "000016450760"
              },
              "productName": {
                "type": "string",
                "enum": [
                  "directRelations",
                  "totalConcern",
                  "deedOfIncorporation",
                  "actOfIncorporation",
                  "amendmentOfArticlesOfAssociation",
                  "deedOfMerger",
                  "rectification",
                  "deedOfDivision",
                  "mostRecentArticlesOfAssociation",
                  "mergerDemergerProposal",
                  "demergerDeed",
                  "latestArticlesOfAssociation",
                  "articlesOfIncorporation",
                  "articlesOfAssociation"
                ],
                "description": "Present for statute and concernRelations orders.",
                "example": "directRelationships"
              },
              "productDate": {
                "type": "string",
                "description": "Present for `standardStatute`, `maskedStatute` and `annualAccounts` orders. Can be a full date or a year.",
                "oneOf": [
                  {
                    "type": "string",
                    "format": "date",
                    "example": "2023-12-06"
                  },
                  {
                    "type": "string",
                    "pattern": "^\\d{4}$",
                    "example": "2023"
                  }
                ]
              },
              "mimeTypes": {
                "type": "array",
                "description": "Available mime types for downloading this order's document. May\nbe absent when the order is still `pending` or has `failed`.\n",
                "items": {
                  "type": "string",
                  "enum": [
                    "application/pdf",
                    "application/json",
                    "application/zip",
                    "text/html"
                  ]
                },
                "example": [
                  "text/html",
                  "application/pdf",
                  "application/json",
                  "application/zip"
                ]
              },
              "createdAt": {
                "type": "string",
                "format": "date-time",
                "example": "2024-03-15T11:19:39+01:00"
              }
            }
          },
          "links": {
            "type": "object",
            "properties": {
              "self": {
                "type": "string",
                "format": "uri-reference"
              }
            }
          }
        }
      },
      "JSONAPIErrorResponse": {
        "title": "JSON:API Error Response",
        "type": "object",
        "required": [
          "errors"
        ],
        "properties": {
          "errors": {
            "title": "An array of Error objects",
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "object",
              "required": [
                "status",
                "code",
                "title",
                "detail"
              ],
              "properties": {
                "status": {
                  "description": "the HTTP status code applicable to this problem",
                  "type": "string",
                  "minLength": 3,
                  "maxLength": 3
                },
                "code": {
                  "description": "an application-specific error code. It can be the same as 'status'",
                  "type": "string"
                },
                "title": {
                  "description": "a short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization",
                  "type": "string"
                },
                "detail": {
                  "description": "a human-readable explanation specific to this occurrence of the problem. Like title, this field’s value can be localized",
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "responses": {
      "BadRequest": {
        "description": "Bad Request",
        "content": {
          "application/vnd.api+json": {
            "schema": {
              "$ref": "#/components/schemas/JSONAPIErrorResponse"
            }
          }
        }
      },
      "InternalServerError": {
        "description": "Internal Server Error",
        "content": {
          "application/vnd.api+json": {
            "schema": {
              "$ref": "#/components/schemas/JSONAPIErrorResponse"
            }
          }
        }
      }
    }
  }
}
```