---
title: "GET /udl/isrcollection/tuple"
method: GET
path: "/udl/isrcollection/tuple"
tags: ["Sensor Tasking"]
---

# GET /udl/isrcollection/tuple

`GET /udl/isrcollection/tuple`

## Request

- Base URL: `https://unifieddatalibrary.com`
- URL: `https://unifieddatalibrary.com/udl/isrcollection/tuple`
- Auth: none declared

Service operation to dynamically query data and only return specified columns/fields. Requested columns are specified by the 'columns' query parameter and should be a comma separated list of valid fields for the specified data type. classificationMarking is always returned. See the queryhelp operation (`/udl/<datatype>/queryhelp`) for more details on valid/required query parameter information. An example URI: /udl/elset/tuple?columns=satNo,period&epoch=>now-5 hours would return the satNo and period of elsets with an epoch greater than 5 hours ago.

## Query parameters

- `columns` string, required
- `createdAt` string, date, required
- `firstResult` integer
- `maxResults` integer

## Response `200`

OK

- ISRCollectionFull[]
  - `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.
  - `idexVersion` integer: Version of the IDEX software the request came from for compatibility.
  - `name` string: Human readable Mission Name.
  - `missionId` string: Mission Identifier.
  - `missionAOR` string: Designation of mission Area Of Responsibility.
  - `missionPrimaryIntelDiscipline` string: Primary type of intelligence to be collected during the mission.
  - `missionPrimarySubCategory` string: Sub category of primary intelligence to be collected.
  - `missionSecondaryIntelDiscipline` string: Type of intelligence to be collected second.
  - `missionSecondarySubCategory` string: Mission sub category for secondary intelligence discipline to be collected.
  - `missionRole` string: What is the primary objective(Role) of this mission.
  - `missionOperation` string: Mission operation name.
  - `missionPriority` integer: Mission Priority (1-n).
  - `missionSupportedUnit` string: Name of the Supporting unit/Location that is performing this mission.
  - `missionEmphasis` string: Text version of what we are emphasizing in this mission.
  - `missionStartPointLat` number, double: WGS-84 latitude of the start position, in degrees. -90 to 90 degrees (negative values south of equator).
  - `missionStartPointLong` number, double: WGS-84 longitude of the start position, in degrees. -180 to 180 degrees (negative values west of Prime Meridian).
  - `missionCollectionArea` string: Mission geographical collection area.
  - `missionJoa` string: Joint Operations Area.
  - `missionSyncMatrixBin` string: A synchronization matrix is used to organize the logistics synchronization process during a mission.
  - `missionCountry` string: Country code of the mission. A Country may represent countries, multi-national consortiums, and international organizations.
  - `missionRegion` string: Region of the mission.
  - `missionSubRegion` string: Subregion of the mission.
  - `collectionRequirements` ISRCollectionRequirementsFull[]: Mission desired collection requirements.
    - `id` string: Collection Requirement Unique Identifier.
    - `hash` string: Encryption hashing algorithm.
    - `type` string: Type collection this requirement applies to.
    - `cridNumbers` string: Collection Requirement Unique Identifier.
    - `priority` number, double: 1-n priority for this collection requirement.
    - `recordId` string: Record id.
    - `reconSurvey` string: Reconnaissance Survey information the operator needs.
    - `intelDiscipline` string: Primary type of intelligence to be collected for this requirement.
    - `secondary` boolean: Sub category of primary intelligence to be collected for this requirement.
    - `emphasized` boolean: Is this collection requirement an emphasized/critical requirement.
    - `isPrismCr` boolean: Is this collection request for the Prism system?.
    - `start` string, date-time: Start time for this requirement, should be within the mission time window.
    - `stop` string, date-time: Stop time for this requirement, should be within the mission time window.
    - `operation` string: Human readable name for this operation.
    - `supportedUnit` string: The name of the military unit that this assigned collection requirement will support.
    - `country` string: Country code of the collection requirement. A Country may represent countries, multi-national consortiums, and international organizations.
    - `region` string: Region of the collection requirement.
    - `subregion` string: Subregion of the collection requirement.
    - `specialComGuidance` string: Free text field for the user to specify special instructions needed for this collection.
    - `criticalTimes` ISRCollectionCriticalTimesFull
      - `earliestImagingTime` string, date-time, required: Critical start time to collect an image for this requirement.
      - `latestImagingTime` string, date-time, required: Critical stop time to collect an image for this requirement.
    - `exploitationRequirement` ISRCollectionExploitationRequirementFull
      - `id` string: Exploitation requirement id.
      - `amplification` string: Amplifying data for the exploitation requirement.
      - `reportingCriteria` string: The reporting criteria of the collection requirement.
      - `dissemination` string: List of e-mails to disseminate collection verification information.
      - `eei` string: Essential Elements of Information.
      - `poc` ISRCollectionPOCFull
        - `id` string: Unique identifier of the collection requirement POC.
        - `name` string: Name of the POC.
        - `callsign` string: Callsign of the POC.
        - `unit` string: Unit the POC belongs to.
        - `email` string: Email address of the POC.
        - `phone` string: Phone number of the POC.
        - `radioFrequency` number, double: Radio Frequency the POC is on.
        - `chatSystem` string: Chat system the POC is accessing.
        - `chatName` string: Chat name of the POC.
        - `notes` string: Amplifying notes about the POC.
    - `targetList` string[]: Array of POI Id's for the targets being tasked.
  - `transit` ISRCollectionTransitFull[]: Object for data dissemination.
    - `id` string: Transit Unique Identifier.
    - `base` string: Military Base to transmit the dissemination of this data.
    - `duration` number, double: Length of mission in milliseconds.
  - `taskings` ISRCollectionTaskingsFull[]: Individual taskings to complete the mission.
    - `id` string: Tasking Unique Identifier.
    - `type` 'Deliberate' | 'Dynamic' | 'Training' | 'Transit': Type of tasking.
    - `collectionType` 'Simultaneous' | 'Sequential' | 'Operationally' | 'Driven' | 'Priority' | 'Order': Type of collection tasked.
    - `taskingAOR` string: Human readable definition of this taskings Area Of Responsibility.
    - `eightLine` string: Eight line.
    - `taskingPrimaryIntelDiscipline` string: Primary type of intelligence to be collected during the mission.
    - `taskingPrimarySubCategory` string: Sub category of primary intelligence to be collected.
    - `taskingSecondaryIntelDiscipline` string: Type of tasking intelligence to be collected second.
    - `taskingSecondarySubCategory` string: Mission sub category for secondary intelligence discipline to be collected.
    - `taskingRole` string: What is the primary objective (role) of this task.
    - `taskingOperation` string: Tasking operation name.
    - `taskingPriority` number, double: Tasking Priority (1-n).
    - `taskingSupportedUnit` string: Military Base to transmit the dissemination of this data.
    - `taskingEmphasis` string: Tasking emphasis.
    - `taskingRetaskTime` string, date-time: Time of retasking, in ISO 8601 UTC format.
    - `taskingStartPointLat` number, double: WGS-84 latitude of the start position, in degrees. -90 to 90 degrees (negative values south of equator).
    - `taskingStartPointLong` number, double: WGS-84 longitude of the start position, in degrees. -180 to 180 degrees (negative values west of Prime Meridian).
    - `taskingCollectionArea` string: Tasking geographical collection area.
    - `taskingJoa` string: Joint Operations Area.
    - `taskingSyncMatrixBin` string: A synchronization matrix is used to organize the logistics synchronization process during a mission.
    - `taskingCountry` string: Country code of the tasking. A Country may represent countries, multi-national consortiums, and international organizations.
    - `taskingRegion` string: Region of the tasking.
    - `taskingSubRegion` string: Subregion of the tasking.
    - `sroTrack` string: Value of the Sensitive Reconnaissance Operations Track.
    - `specialComGuidance` string: Free text field for the user to specify special instructions needed for this collection.
    - `collectionPeriods` ISRCollectionPeriodsFull
      - `planned` ISRCollectionPlannedFull
        - `start` string, date-time: Start time of collection, in ISO 8601 UTC format.
        - `stop` string, date-time: Stop time of collection, in ISO 8601 UTC format.
        - `additional` ISRCollectionAdditionalFull[]: Additional start and stop for the collection.
          - `id` string: Unique Identifier of additional collection period.
          - `start` string, date-time: Start time of collection, in ISO 8601 UTC format.
          - `stop` string, date-time: Stop time of collection, in ISO 8601 UTC format.
      - `actual` ISRCollectionActualFull[]: Actual start and stop for the collection.
        - `id` string: Unique Identifier of actual collection period for historical archive.
        - `start` string, date-time: Start time the collection actually occurred, in ISO 8601 UTC format.
        - `stop` string, date-time: Stop time the collection actually occurred, in ISO 8601 UTC format.
    - `taskingCollectionRequirements` ISRCollectionRequirementsFull[]: Tasking desired collection requirements.
      - `id` string: Collection Requirement Unique Identifier.
      - `hash` string: Encryption hashing algorithm.
      - `type` string: Type collection this requirement applies to.
      - `cridNumbers` string: Collection Requirement Unique Identifier.
      - `priority` number, double: 1-n priority for this collection requirement.
      - `recordId` string: Record id.
      - `reconSurvey` string: Reconnaissance Survey information the operator needs.
      - `intelDiscipline` string: Primary type of intelligence to be collected for this requirement.
      - `secondary` boolean: Sub category of primary intelligence to be collected for this requirement.
      - `emphasized` boolean: Is this collection requirement an emphasized/critical requirement.
      - `isPrismCr` boolean: Is this collection request for the Prism system?.
      - `start` string, date-time: Start time for this requirement, should be within the mission time window.
      - `stop` string, date-time: Stop time for this requirement, should be within the mission time window.
      - `operation` string: Human readable name for this operation.
      - `supportedUnit` string: The name of the military unit that this assigned collection requirement will support.
      - `country` string: Country code of the collection requirement. A Country may represent countries, multi-national consortiums, and international organizations.
      - `region` string: Region of the collection requirement.
      - `subregion` string: Subregion of the collection requirement.
      - `specialComGuidance` string: Free text field for the user to specify special instructions needed for this collection.
      - `criticalTimes` ISRCollectionCriticalTimesFull
        - `earliestImagingTime` string, date-time, required: Critical start time to collect an image for this requirement.
        - `latestImagingTime` string, date-time, required: Critical stop time to collect an image for this requirement.
      - `exploitationRequirement` ISRCollectionExploitationRequirementFull
        - `id` string: Exploitation requirement id.
        - `amplification` string: Amplifying data for the exploitation requirement.
        - `reportingCriteria` string: The reporting criteria of the collection requirement.
        - `dissemination` string: List of e-mails to disseminate collection verification information.
        - `eei` string: Essential Elements of Information.
        - `poc` ISRCollectionPOCFull
          - `id` string: Unique identifier of the collection requirement POC.
          - `name` string: Name of the POC.
          - `callsign` string: Callsign of the POC.
          - `unit` string: Unit the POC belongs to.
          - `email` string: Email address of the POC.
          - `phone` string: Phone number of the POC.
          - `radioFrequency` number, double: Radio Frequency the POC is on.
          - `chatSystem` string: Chat system the POC is accessing.
          - `chatName` string: Chat name of the POC.
          - `notes` string: Amplifying notes about the POC.
      - `targetList` string[]: Array of POI Id's for the targets being tasked.
  - `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, example = 2018-01-01T16:00:00.123Z.
  - `updatedBy` string: Application user who updated the row in the database, auto-populated by the system.
  - `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.
  - `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.
  - `origNetwork` string: The originating source network on which this record was created, auto-populated by the system.

## Other responses

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

## Changes

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

- **2025-05-29** `4e1cbc17e814`: 2 info
  - added the new optional `query` request parameter `firstResult`
  - added the new optional `query` request parameter `maxResults`
- **2025-04-16** `75f764c843a9`: 4 breaking, 2 info
  - the `items/collectionRequirements/items/targetList/items/` response property's maxLength was unset from `64` for the response status `200`
  - the `items/taskings/items/taskingCollectionRequirements/items/targetList/items/` response property's maxLength was unset from `64` for the response status `200`
  - the `items/collectionRequirements/items/targetList/items/` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `items/taskings/items/taskingCollectionRequirements/items/targetList/items/` response property's minLength was decreased from `1` to `0` for the response status `200`
  - …2 more

[Operation history](https://skmtc.dev/bluestaq/apis/unified-data-library-services-api/changes/udl/isrcollection/tuple/get.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)
