---
title: "POST /udl/airspacecontrolorder/createBulk"
method: POST
path: "/udl/airspacecontrolorder/createBulk"
tags: ["AirOperations"]
---

# POST /udl/airspacecontrolorder/createBulk

`POST /udl/airspacecontrolorder/createBulk`

## Request

- Base URL: `https://unifieddatalibrary.com`
- URL: `https://unifieddatalibrary.com/udl/airspacecontrolorder/createBulk`
- Auth: none declared

Service operation intended for initial integration only, to take a list of AirspaceControlOrder records as a POST body and ingest into the database. This operation is not intended to be used for automated feeds into UDL. Data providers should contact the UDL team for specific role assignments and for instructions on setting up a permanent feed through an alternate mechanism.

## Request body

- AirspaceControlOrderIngest[]
  - `id` string: Unique identifier of the record, auto-generated by the system.
  - `classificationMarking` string, required: Classification marking of the data in IC/CAPCO Portion-marked format.
  - `opExName` string, required: Specifies the unique operation or exercise name, nickname, or codeword assigned to a joint exercise or operation plan.
  - `originator` string, required: The identifier of the originator of this message.
  - `startTime` string, date-time, required: The start of the effective time period of this airspace control order, in ISO 8601 UTC format with millisecond precision.
  - `stopTime` string, date-time: The end of the effective time period of this airspace control order, in ISO 8601 UTC format with millisecond precision.
  - `stopQualifier` string: A qualifier for the end of the effective time period of this airspace control order, such as AFTER, ASOF, NLT, etc. Used with field stopTime to indicate a relative time.
  - `opExInfo` string: Supplementary name that can be used to further identify exercise nicknames, or to provide the primary nickname of the option or the alternative of an operational plan.
  - `opExInfoAlt` string: The secondary supplementary nickname of the option or the alternative of the operational plan or order.
  - `planOrigNum` string: The official identifier of the military establishment responsible for the operation plan and the identification number assigned to this plan.
  - `serialNum` string: The unique message identifier sequentially assigned by the originator.
  - `month` string: The month in which the message originated.
  - `qualifier` string: The qualifier which caveats the message status.
  - `qualSN` integer: The serial number associated with the message qualifier.
  - `areaOfValidity` string: Name of the area of the command for which the ACO is valid.
  - `acoSerialNum` string: The serial number of this airspace control order.
  - `geoDatum` string: Specifies the geodetic datum by which the spatial coordinates of the controlled airspace are calculated.
  - `acoComments` string: Free text information expressed in natural language.
  - `airspaceControlOrderReferences` AirspaceControlOrderReferenceIngest[]: The airspaceControlReferences set provides both USMTF and non-USMTF references for this airspace control order.
    - `refSId` string: Specifies an alphabetic serial number identifying a reference pertaining to this message.
    - `refType` string: Specifies the type for this reference.
    - `refOriginator` string: The originator of this reference.
    - `refTs` string, date-time: Timestamp of the referenced message, in ISO 8601 UTC format with millisecond precision.
    - `refSerialNum` string: The reference serial number.
    - `refSpecialNotation` string: Indicates any special actions, restrictions, guidance, or information relating to this reference.
    - `refSICs` string[]: Array of NATO Subject Indicator Codes (SIC) or filing numbers of the document being referenced.
  - `airspaceControlMeansStatus` AirspaceControlMeansStatusIngest[]: Mandatory nested segment to report multiple airspace control means statuses within an ACOID.
    - `cmStat` string: Status of Airspace Control Means. Must be ADD, CHANGE, or DELETE.
    - `cmStatId` string[]: Airspace control means name or designator. Mandatory if acmStat equals "DELETE," otherwise this field is prohibited.
    - `airspaceControlMeans` AirspaceControlMeansIngest[]: A conditional nested segment to report multiple airspace control means within a particular airspace control means status.
      - `cmType` string: The code for the type of airspace control means.
      - `cmId` string: Airspace control means name or designator.
      - `cmShape` 'POLYARC' | '1TRACK' | 'POLYGON' | 'CIRCLE' | 'CORRIDOR' | 'APOINT' | 'AORBIT' | 'GEOLINE': Designates the geometric type that defines the airspace shape. One of CIRCLE, CORRIDOR, LINE, ORBIT, etc.
      - `usage` string: Designates the means by which a defined airspace control means is to be used.
      - `link16Id` string: Unique Link 16 identifier assigned to the airspace control means.
      - `transAltitude` string: The altitude at or below which the vertical position of an aircraft is controlled by reference to true altitude.
      - `geoDatumAlt` string: Specifies the geodetic datum by which the spatial coordinates of the controlled airspace are calculated, if different from the top level ACO datum.
      - `coord0` string: A geospatial point coordinate specified in DMS (Degrees, Minutes, Seconds) format. The fields coord0 and coord1 should be used in the specification of any airspace control shape that requires exactly one (1) or two (2) reference points for construction. For shapes requiring one reference point, for instance, when cmShape is set to "APOINT", this field is required and singularly defines the shape. Similarly, this field is required to define the center point of a "CIRCLE" shape, or the "origin of bearing" for arcs.
      - `coord1` string: A geospatial point coordinate specified in DMS (Degrees, Minutes, Seconds) format. The fields coord0 and coord1 should be used in the specification of any airspace control shape that requires exactly one (1) or two (2) reference points for construction. For shapes requiring one reference point, for instance, when cmShape is set to "APOINT", this field is required and singularly defines the shape. Similarly, this field is required to define the center point of a "CIRCLE" shape, or the "origin of bearing" for arcs.
      - `bearing0` number, double: A bearing measured from true North, in angular degrees. If cmShape is set to "POLYARC" or "RADARC", this field is required and is mapped to the "beginning" radial bearing parameter.
      - `bearing1` number, double: A bearing measured from true North, in angular degrees. If cmShape is set to "POLYARC" or "RADARC", this field is required and is mapped to the "ending" radial bearing parameter.
      - `radMag0` number, double: A distance that represents a radial magnitude. If cmShape is set to "CIRCLE" or "POLYARC", one of either fields radMag0 or radMag1 is required. If cmShape is set to "RADARC", this field is required and maps to the "inner" radial magnitude arc limit. If provided, the field radMagUnit is required.
      - `radMag1` number, double: A distance that represents a radial magnitude. If cmShape is set to "CIRCLE" or "POLYARC", one of either fields radMag0 or radMag1 is required. If cmShape is set to "RADARC", this field is required and maps to the "outer" radial magnitude arc limit. If provided, the field radMagUnit is required.
      - `radMagUnit` string: Specifies the unit of length in which radial magnitudes are given. Use M for meters, KM for kilometers, or NM for nautical miles.
      - `polyCoord` string[]: A set of geospatial coordinates specified in DMS (Degrees, Minutes, Seconds) format which determine the vertices of a one or two dimensional geospatial shape. When cmShape is set to "POLYARC" or "POLYGON", this field is required as applied in the construction of the area boundary. If cmShape is set to "CORRIDOR" or "GEOLINE", this field is required and can be interpreted as an ordered set of points along a path in space.
      - `trackLeg` integer: Index of a segment in an airtrack, which is defined by an ordered set of points.
      - `widthLeft` number, double: Given an ordered pair of spatial coordinates (p0, p1), defines a distance extending into the LEFT half-plane relative to the direction of the vector that maps p0 to p1. If cmShape is set to "1TRACK", this field is required to define the width of the airspace track as measured from the left of the track segment line. If provided, the field widthUnit is required.
      - `widthRight` number, double: Given an ordered pair of spatial coordinates (p0, p1), defines a distance extending into the RIGHT half-plane relative to the direction of the vector that maps p0 to p1. If cmShape is set to "1TRACK", this field is required to define the width of the airspace track as measured from the right of the track segment line. If provided, the field widthUnit is required.
      - `width` number, double: Used to describe the "side to side" distance of a target, object or area. If cmShape is set to "CORRIDOR" or "AORBIT", this field is required and is mapped to the width parameter. If provided, the field widthUnit is required.
      - `widthUnit` string: Specifies the unit of length for which widths are given. Use M for meters, KM for kilometers, or NM for nautical miles.
      - `corrWayPoints` string[]: An array of at least two alphanumeric symbols used to serially identify the corridor waypoints. If cmShape is set to "CORRIDOR", one of either corrWayPoints or polyCoord is required to specify the centerline of the corridor path.
      - `orbitAlignment` string: Orbit alignment look-up code. Can be C=Center, L=Left, R=Right.
      - `effVDim` string: Description of the airspace vertical dimension.
      - `airspaceTimePeriod` AirspaceTimePeriodIngest[]: The timePeriods set describes the effective datetime for a given airspace control means.
        - `timeMode` string: The airspace time code associated with the ACO. Can be DISCRETE, a fixed time block, or INTERVAL, a repeating time block.
        - `timeStart` string: The start time designating that the airspace control order is active.
        - `timeEnd` string: The end time designating that the airspace control order is no longer active. Can contain datetime information or a stop time qualifier code, such as AFTER, NET, UFN, etc.
        - `intFreq` string[]: Mandatory if timeMode is INTERVAL. Can be one of the interval frequency codes, such as BIWEEKLY, DAILY, YEARLY, etc.
        - `intDur` string[]: Mandatory if timeMode is INTERVAL. Can be a numerical multiplier on an interval frequency code, a stop time qualifier code such as AFTER, NET, UFN, etc, or a datetime like string.
      - `airspaceControlPoint` AirspaceControlPointIngest[]: The controlPoint set describes any reference/controlling/rendezvous point for a given airspace control means.
        - `ctrlPtType` string: One of possible control point type codes, such as CP, ER, OT, etc.
        - `ctrlPtName` string: The name applied to the control point, used as a reference.
        - `ctrlPtLocation` string: A geospatial point coordinate specified in DMS (Degrees, Minutes, Seconds) format that represents the location of the control point.
        - `ctrlPtAltitude` string: The altitude of the control point.
      - `cntrlAuth` string: The commander responsible within a specified geographical area for the airspace control operation assigned to him.
      - `cntrlAuthFreqs` string[]: The frequency for the airspace control authority. Can specify HZ, KHZ, MHZ, GHZ or a DESIG frequency designator code.
      - `genTextInd` string: Used to provide transit instructions for the airspace control means.
      - `freeText` string: General informat detailing the transit instruction for the airspace control means.
  - `undLnkTrks` string[]: Array of unique link 16 identifiers that will be assigned to a future airspace control means.
  - `classSource` string: Markings defining the source material or the original classification authority for the ACO message.
  - `classReasons` string[]: Mandatory if classSource uses the "IORIG" designator. Must be a REASON FOR CLASSIFICATION code.
  - `downgradeInsDates` string[]: Markings providing the literal guidance or date for downgrading or declassifying the airspace control order.
  - `declassExemptionCodes` string[]: Coded entries that provide justification for exemption from automatic downgrading or declassification of the airspace control order.
  - `createdAt` string, date-time: Time the row was created in the database, auto-populated by the system.
  - `createdBy` string: Application user who created the row in the database, auto-populated by the system.
  - `sourceDL` string: The source data library from which this record was received. This could be a remote or tactical UDL or another data library. If null, the record should be assumed to have originated from the primary Enterprise UDL.
  - `source` string, required: Source of the data.
  - `origin` string: Originating system or organization which produced the data, if different from the source. The origin may be different than the source if the source was a mediating system which forwarded the data on behalf of the origin system. If null, the source may be assumed to be the origin.
  - `origNetwork` string: The originating source network on which this record was created, auto-populated by the system.
  - `dataMode` 'REAL' | 'TEST' | 'SIMULATED' | 'EXERCISE', required: Indicator of whether the data is REAL, TEST, EXERCISE, or SIMULATED data: REAL: Data collected or produced that pertains to real-world objects, events, and analysis. TEST: Specific datasets used to evaluate compliance with specifications and requirements, and for validating technical, functional, and performance characteristics. EXERCISE: Data pertaining to a government or military exercise. The data may include both real and simulated data. SIMULATED: Synthetic data generated by a model to mimic real-world datasets.

## Response `204`

Success

## Other responses

- `400`: Bad Request
- `401`: Invalid/Missing User Credentials
- `403`: User Is Not Authorized
- `405`: Method Not Allowed
- `415`: MediaType Unsupported
- `429`: Rate of Requests Exceeds Allowed Limit
- `500`: Internal Server Error

## Changes

> 12 revisions in range; 1 could not be searched.

- **2025-09-26** `45631f9bb3f0`: 1 breaking
  - the `items/origNetwork` request property's minLength was increased from `0` to `1`
- **2025-04-16** `75f764c843a9`: 2 info
  - api operation id `createBulks_3` removed and replaced with ``
  - the endpoint scheme security `BasicAuth` was removed from the API

[Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/airspacecontrolorder/createBulk/post.md)

---

[API](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api.md) - [All operations](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/revisions/bd17bc53681e?raw)