--- title: "POST /udl/diplomaticclearancecountry/createBulk" method: POST path: "/udl/diplomaticclearancecountry/createBulk" tags: ["AirOperations"] --- # POST /udl/diplomaticclearancecountry/createBulk `POST /udl/diplomaticclearancecountry/createBulk` ## Request - Base URL: `https://unifieddatalibrary.com` - URL: `https://unifieddatalibrary.com/udl/diplomaticclearancecountry/createBulk` - Auth: none declared Service operation intended for initial integration only, to take a list of diplomaticclearancecountry 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 - DiplomaticClearanceCountryIngest[] - `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. - `lastChangedDate` string, date-time, required: Last time this country's diplomatic clearance profile information was updated, in ISO 8601 UTC format with millisecond precision. - `countryCode` string, required: The DoD Standard Country Code designator for the country for which the diplomatic clearance will be issued. This field should be set to "OTHR" if the source value does not match a UDL country code value (ISO-3166-ALPHA-2). - `altCountryCode` string: Specifies an alternate country code if the data provider code does not match a UDL Country code value (ISO-3166-ALPHA-2). This field will be set to the value provided by the source and should be used for all Queries specifying a Country Code. - `countryId` string: System generated code used to identify a country. - `countryName` string: Name of the country for which the diplomatic clearance will be issued. - `gmtOffset` string: Time difference between the location of the country for which the diplomatic clearance will be issued and the Greenwich Mean Time (GMT), expressed as +/-HH:MM. Time zones east of Greenwich have positive offsets and time zones west of Greenwich are negative. - `countryRemark` string: Remarks concerning the country for which the diplomatic clearance will be issued. - `existingProfile` boolean: Flag indicating whether a diplomatic clearance profile exists for this country. - `openMon` boolean: Flag indicating whether this country's diplomatic clearance office is open on Monday. - `openTue` boolean: Flag indicating whether this country's diplomatic clearance office is open on Tuesday. - `openWed` boolean: Flag indicating whether this country's diplomatic clearance office is open on Wednesday. - `openThu` boolean: Flag indicating whether this country's diplomatic clearance office is open on Thursday. - `openFri` boolean: Flag indicating whether this country's diplomatic clearance office is open on Friday. - `openSat` boolean: Flag indicating whether this country's diplomatic clearance office is open on Saturday. - `openSun` boolean: Flag indicating whether this country's diplomatic clearance office is open on Sunday. - `openTime` string: Zulu opening time of this country's diplomatic clearance office expressed in HH:MM format. - `closeTime` string: Zulu closing time of this country's diplomatic clearance office expressed in HH:MM format. - `acceptsEmail` boolean: Flag indicating whether this country's diplomatic clearance office can receive messages via email. - `acceptsDMS` boolean: Flag indicating whether this country's diplomatic clearance office can receive messages using the Defense Message System (DMS). - `acceptsFax` boolean: Flag indicating whether this country's diplomatic clearance office can receive messages via fax. - `acceptsSIPRNet` boolean: Flag indicating whether this country's diplomatic clearance office can receive messages via SIPRNet. - `agency` string: The source agency of the diplomatic clearance country data. - `officeName` string: Name of this country's diplomatic clearance office. - `officePOC` string: Name of the point of contact for this country's diplomatic clearance office. - `officeRemark` string: Remarks concerning this country's diplomatic clearance office. - `diplomaticClearanceCountryEntryExitPoints` DiplomaticClearanceCountryEntryExitPointIngest[]: Collection of diplomatic clearance profile information for this country. - `pointName` string: Name of this entry/exit point. - `isEntry` boolean: Flag indicating whether this is a point of entry for this country. - `isExit` boolean: Flag indicating whether this is a point of exit for this country. - `diplomaticClearanceCountryProfiles` DiplomaticClearanceCountryProfileIngest[]: Collection of diplomatic clearance profile information for this country. - `profileId` string: Identifier of the diplomatic clearance country profile. - `profile` string: The diplomatic clearance profile name used within clearance management systems. - `profileAgency` string: The agency to which this profile applies. - `clearanceId` string: Identifier of the associated diplomatic clearance issued by the host country. - `reqACAltName` boolean: Flag indicating whether alternate aircraft names are required to be reported to the country using this diplomatic clearance profile. - `reqCrewComp` boolean: Flag indicating whether the number of crew members on a flight is required to be reported to the country using this diplomatic clearance profile. - `reqCrewDetail` boolean: Flag indicating whether the names, ranks, and positions of crew members are required to be reported to the country using this diplomatic clearance profile. - `reqDV` boolean: Flag indicating whether distinguished visitors are required to be reported to the country using this diplomatic clearance profile. - `reqRaven` boolean: Flag indicating whether ravens are required to be reported to the country using this diplomatic clearance profile. - `reqCargoList` boolean: Flag indicating whether a cargo list is required to be reported to the country using this diplomatic clearance profile. - `reqFltPlanRoute` boolean: Flag indicating whether a flight plan route is required to be reported to the country using this diplomatic clearance profile. - `reqICAO` boolean: Flag indicating whether this diplomatic clearance profile applies to specific ICAO(s). These specific ICAO(s) should be clarified in the fltInfoRemark field. - `reqEntryExitCoord` boolean: Flag indicating whether entry/exit coordinates need to be specified for this diplomatic clearance profile. - `reqTailNum` boolean: Flag indicating whether an aircraft tail number is required to be reported to the country using this diplomatic clearance profile. - `reqFltInfo` boolean: Flag indicating whether flight information is required to be reported to the country using this diplomatic clearance profile. - `fltInfoRemark` string: Remarks concerning flight information for this country profile. - `reqCrewInfo` boolean: Flag indicating whether crew information is required to be reported to the country using this diplomatic clearance profile. - `crewInfoRemark` string: Remarks concerning crew information for this country profile. - `reqCargoPax` boolean: Flag indicating whether aircraft cargo and passenger information is required to be reported to the country using this diplomatic clearance profile. - `cargoPaxRemark` string: Remarks concerning aircraft cargo and passenger information for this country profile. - `reqHazInfo` boolean: Flag indicating whether hazardous material information is required to be reported to the country using this diplomatic clearance profile. - `reqAllHazInfo` boolean: Flag indicating whether all hazardous material information is required to be reported to the country using this diplomatic clearance profile. - `hazInfoRemark` string: Remarks concerning hazardous material information for this country profile. - `reqPassportInfo` boolean: Flag indicating whether passport information is required to be reported to the country using this diplomatic clearance profile. - `reqFundSource` boolean: Flag indicating whether aviation funding sources are required to be reported to the country using this diplomatic clearance profile. - `reqAMCStdInfo` boolean: Flag indicating whether standard AMC information is required to be reported to the country using this diplomatic clearance profile. - `reqClass1Info` boolean: Flag indicating whether Class 1 hazardous material information is required to be reported to the country using this diplomatic clearance profile. - `reqDiv1Info` boolean: Flag indicating whether Division 1.1 hazardous material information is required to be reported to the country using this diplomatic clearance profile. - `reqClass9Info` boolean: Flag indicating whether Class 9 hazardous material information is required to be reported to the country using this diplomatic clearance profile. - `reqWeaponsInfo` boolean: Flag indicating whether weapons information is required to be reported to the country using this diplomatic clearance profile. - `reqRepChange` boolean: Flag indicating whether changes are required to be reported to the country using this diplomatic clearance profile. - `undefinedCrewReporting` boolean: Flag indicating whether crew reporting is undefined for the country using this diplomatic clearance profile. - `defEntryRemark` string: Remarks concerning the default entry point for this country. - `defEntryTime` string: Zulu default entry time for this country expressed in HH:MM format. - `defExitRemark` string: Remarks concerning the default exit point for this country. - `defExitTime` string: Zulu default exit time for this country expressed in HH:MM format. - `defClearanceStatus` string: Code denoting the status of the default diplomatic clearance (e.g., A for Approved via APACS, E for Requested via email, etc.). - `landDefProf` boolean: Flag indicating whether this is the default landing profile for this country. - `landLeadTime` integer: Amount of lead time required for an aircraft to land in this country. Units need to be specified in the landLeadTimeUnit field. - `landLeadTimeUnit` string: Unit of time specified for the landLeadTime field to indicate the landing lead time required for this country. - `landLeadTimeRemark` string: Remarks concerning the landing lead time required for this country. - `landValidPeriodPlus` integer: Amount of time after the landing valid period that an aircraft is allowed to land in this country for this profile. The unit of time should be specified in the landValidPeriodUnit field. - `landValidPeriodMinus` integer: Amount of time before the landing valid period that an aircraft is allowed to land in this country for this profile. The unit of time should be specified in the landValidPeriodUnit field. - `landValidPeriodUnit` string: Unit of time specified for the landValidPeriodPlus and landValidPeriodMinus fields to indicate the valid landing period for this country. - `landValidPeriodRemark` string: Remarks concerning the valid landing time period for this country. - `overflyDefProf` boolean: Flag indicating whether this is the default overfly profile for this country. - `overflyLeadTime` integer: Amount of lead time required for an aircraft to enter and fly over the airspace of this country. Units need to be specified in the overflyLeadTimeUnit field. - `overflyLeadTimeUnit` string: Unit of time specified for the overflyLeadTime field to indicate the overfly lead time required for this country. - `overflyLeadTimeRemark` string: Remarks concerning the overfly lead time required for this country. - `overflyValidPeriodPlus` integer: Amount of time after the overfly valid period that an aircraft is allowed to fly over this country for this profile. The unit of time should be specified in the overflyValidPeriodUnit field. - `overflyValidPeriodMinus` integer: Amount of time before the overfly valid period that an aircraft is allowed to fly over this country for this profile. The unit of time should be specified in the overflyValidPeriodUnit field. - `overflyValidPeriodUnit` string: Unit of time specified for the overflyValidPeriodPlus and overflyValidPeriodMinus fields to indicate the valid overfly period for this country. - `overflyValidPeriodRemark` string: Remarks concerning the valid overfly time period for this country. - `profileRemark` string: Remarks concerning this country profile. - `diplomaticClearanceCountryContacts` DiplomaticClearanceCountryContactIngest[]: Collection of diplomatic clearance profile information for this country. - `contactId` string: Identifier of the contact for this country. - `contactName` string: Name of the contact for this country. - `dsnSpdDialCode` string: Defense Switched Network (DSN) speed dial code for this contact. - `dsnNum` string: Defense Switched Network (DSN) phone number for this contact. - `commSpdDialCode` string: Commercial speed dial code for this contact. - `commNum` string: Commercial phone number for this contact. - `ahSpdDialCode` string: Speed dial code for this contact after regular business hours. - `ahNum` string: Phone number for this contact after regular business hours. - `faxNum` string: Fax number for this contact. - `niprNum` string: Phone number to contact the Diplomatic Attache Office (DAO) for this country over a secure NIPR line. - `siprNum` string: Phone number to contact the Diplomatic Attache Office (DAO) for this country over a secure SIPR line. - `contactRemark` string: Remarks about this contact. - `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. - `updatedAt` string, date-time: Time the row was updated in the database, auto-populated by the system. - `updatedBy` string: Application user who updated 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`: 1 info - endpoint added [Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/diplomaticclearancecountry/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)