--- updatedAt: 2026-05-27T08:26:46.000Z agentTools: projectIndex: https://developer.up42.com/llms.txt --- # Get feasibility studies for tasking orders Get a list of feasibility studies for tasking orders. # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "UP42 API", "contact": { "name": "Contact support", "email": "support@up42.com" }, "license": { "name": "Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License", "url": "http://creativecommons.org/licenses/by-nc-nd/4.0/" }, "version": "1.2" }, "servers": [ { "url": "https://api.up42.com" } ], "security": [ { "httpBearer": [] } ], "tags": [ { "name": "Tasking" } ], "paths": { "/v2/tasking/feasibility-studies": { "get": { "tags": [ "Tasking" ], "summary": "Get feasibility studies for tasking orders", "description": "Get a list of feasibility studies for tasking orders.\n", "operationId": "listTaskingFeasibilityStudies", "parameters": [ { "name": "id", "in": "query", "description": "The feasibility study ID.\n", "required": false, "style": "form", "explode": true, "schema": { "type": "string", "format": "uuid", "example": "68567134-27ad-7bd7-4b65-d61adb11fc78" } }, { "$ref": "#/components/parameters/WorkspaceIdQuery" }, { "$ref": "#/components/parameters/OrderIdQuery" }, { "name": "decision", "in": "query", "description": "The status of feasibility studies.\n", "required": false, "style": "form", "explode": true, "schema": { "type": "array", "nullable": true, "items": { "$ref": "#/components/schemas/FeasibilityStudyDecision" } } }, { "$ref": "#/components/parameters/PageableSize" }, { "$ref": "#/components/parameters/PageablePage" }, { "$ref": "#/components/parameters/PageableSorting" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FeasibilityStudyListResponse" } } } }, "401": { "$ref": "#/components/responses/OrderingUnauthorized" } }, "security": [ { "httpBearer": [] } ] } } }, "components": { "schemas": { "Sort": { "type": "object", "properties": { "empty": { "type": "boolean", "example": false }, "sorted": { "type": "boolean", "example": true }, "unsorted": { "type": "boolean", "example": false } } }, "PageableObject": { "type": "object", "properties": { "pageNumber": { "type": "integer", "format": "int32", "example": 0 }, "pageSize": { "type": "integer", "format": "int32", "example": 10 }, "sort": { "$ref": "#/components/schemas/Sort" }, "offset": { "type": "integer", "format": "int64", "example": 0 }, "paged": { "type": "boolean", "example": true }, "unpaged": { "type": "boolean", "example": false } } }, "WorkspaceId": { "type": "string", "description": "The workspace ID.", "format": "uuid", "nullable": false }, "AccountId": { "type": "string", "description": "The account ID.", "format": "uuid", "nullable": false, "example": "55434287-31bc-3ad7-1a63-d61aac11ac55" }, "Auditor": { "type": "object", "properties": { "id": { "oneOf": [ { "type": "string", "description": "The ID of the user who performed the action.", "format": "uuid", "example": "3fa85f64-5717-4562-b3fc-2c963f66afa6" }, { "type": "string", "description": "A marker that indicates an action was performed automatically. The only allowed value is `system`.", "enum": [ "system" ] } ] }, "type": { "type": "string", "description": "The type of user who performed the action.", "enum": [ "INTERNAL", "ADMIN", "API_KEY", "USER" ] } }, "description": "The ID and type of the user who performed the action.\n" }, "FeasibilityStudyListResponse": { "required": [ "content" ], "type": "object", "properties": { "content": { "type": "array", "items": { "$ref": "#/components/schemas/FeasibilityStudy" } } }, "description": "Feasibility Study Page", "allOf": [ { "$ref": "#/components/schemas/PageableResponse" } ] }, "FeasibilityStudy": { "required": [ "options" ], "type": "object", "properties": { "options": { "minItems": 0, "type": "array", "description": "Options available for the feasibility study.", "nullable": false, "items": { "$ref": "#/components/schemas/FeasibilityOption" } }, "decisionOption": { "type": "object", "description": "The option of the feasibility study that was accepted.", "nullable": true, "anyOf": [ { "$ref": "#/components/schemas/FeasibilityOption" }, { "type": "object", "nullable": true } ] }, "difficulty": { "$ref": "#/components/schemas/FeasibilityDifficulty" } }, "description": "feasibility study DTO", "allOf": [ { "$ref": "#/components/schemas/FeasibilityStudyWithoutOption" } ] }, "FeasibilityStudyWithoutOption": { "required": [ "createdAt", "createdBy", "decision", "id", "updatedAt", "updatedBy" ], "type": "object", "properties": { "id": { "type": "string", "description": "The feasibility study ID.", "format": "uuid", "nullable": false }, "createdAt": { "type": "string", "description": "The time the feasibility study was created.", "format": "date-time", "nullable": false }, "createdBy": { "$ref": "#/components/schemas/Auditor" }, "updatedAt": { "type": "string", "description": "The last time the feasibility study was changed.", "format": "date-time", "nullable": false }, "updatedBy": { "$ref": "#/components/schemas/Auditor" }, "decision": { "$ref": "#/components/schemas/FeasibilityStudyDecision" }, "decisionById": { "type": "string", "description": "The ID of the user that made a decision on this feasibility study.", "format": "uuid", "nullable": true }, "decisionByType": { "type": "string", "description": "The type of user that made a decision on this feasibility study.", "nullable": true, "enum": [ "USER", "ADMIN", "API", "SYSTEM", null ] }, "decisionAt": { "type": "string", "description": "The time the decision was made on this feasibility study.", "format": "date-time", "nullable": true }, "comment": { "type": "string", "description": "Additional information related to the feasibility study. When the feasibility type is `AUTO`, a comment might be provided to give context regarding the assessment.\n", "nullable": true, "example": "Only one tasking opportunity available. Might require schedule adjustment.\n" }, "difficulty": { "$ref": "#/components/schemas/FeasibilityDifficulty" } }, "description": "feasibility study DTO", "allOf": [ { "$ref": "#/components/schemas/FeasibilityStudyPreSave" } ] }, "FeasibilityStudyPreSave": { "required": [ "accountId", "orderId", "type", "workspaceId" ], "type": "object", "properties": { "accountId": { "$ref": "#/components/schemas/AccountId" }, "workspaceId": { "$ref": "#/components/schemas/WorkspaceId" }, "orderId": { "$ref": "#/components/schemas/OrderId" }, "type": { "type": "string", "description": "The feasibility study type.", "nullable": false, "enum": [ "AUTO", "MANUAL" ] }, "difficulty": { "$ref": "#/components/schemas/FeasibilityDifficulty" } }, "description": "feasibility study DTO before creation" }, "FeasibilityStudyDecision": { "type": "string", "description": "The decision for this feasibility study.", "nullable": false, "default": "NOT_DECIDED", "enum": [ "NOT_DECIDED", "ACCEPTED" ] }, "FeasibilityOption": { "required": [ "createdAt", "id", "updatedAt" ], "type": "object", "properties": { "id": { "type": "string", "description": "The feasibility study option ID.", "format": "uuid", "nullable": false, "example": "aa183717-1491-427b-8534-4077f0f86a62" }, "createdAt": { "type": "string", "description": "The time the feasibility study option was created.", "format": "date-time", "nullable": false, "example": "2025-12-13T11:02:44.051539Z" }, "updatedAt": { "type": "string", "description": "The last time the feasibility study option was changed.", "format": "date-time", "nullable": false, "example": "2025-12-13T11:02:44.051539Z" }, "studyId": { "type": "string", "description": "The feasibility study ID.", "format": "uuid", "nullable": false, "example": "77dece60-1964-4e7b-a318-4f0afc04a232" } }, "allOf": [ { "$ref": "#/components/schemas/FeasibilityOptionPreSave" } ] }, "FeasibilityOptionPreSave": { "required": [ "description", "paramType" ], "type": "object", "properties": { "description": { "minLength": 1, "type": "string", "description": "A description of the feasibility study option.", "nullable": false, "example": "Option 1 with 30% cloud coverage" }, "paramType": { "type": "string", "description": "The parameter type for this feasibility option, indicating whether the original order parameters or an alternate set of parameters were used to evaluate this option.\n", "nullable": false, "example": "ORIGINAL_PARAMS", "enum": [ "ORIGINAL_PARAMS", "ALTERNATE_PARAMS" ] } }, "description": "Tasking feasibility study option DTO before creation" }, "PageableResponse": { "type": "object", "properties": { "pageable": { "$ref": "#/components/schemas/PageableObject" }, "last": { "type": "boolean", "example": false }, "totalElements": { "type": "integer", "format": "int64", "example": 100 }, "totalPages": { "type": "integer", "format": "int32", "example": 20 }, "size": { "type": "integer", "format": "int32", "example": 10 }, "number": { "type": "integer", "format": "int32", "example": 0 }, "sort": { "$ref": "#/components/schemas/Sort" }, "numberOfElements": { "type": "integer", "format": "int32", "example": 10 }, "first": { "type": "boolean", "example": true }, "empty": { "type": "boolean", "example": false } } }, "OrderId": { "type": "string", "description": "The order ID.", "format": "uuid", "nullable": false }, "FeasibilityDifficulty": { "type": "string", "description": "The acquisition difficulty determined by order parameters.\n", "nullable": true, "example": "LOW", "enum": [ "LOW", "HIGH", null ] }, "ErrorResponseV1": { "required": [ "error" ], "type": "object", "properties": { "data": { "type": "object", "nullable": true }, "error": { "$ref": "#/components/schemas/ErrorResponseObject" } }, "description": "Legacy error wrapper used for authentication failures and some data-adapter schema errors." }, "ErrorResponseObject": { "required": [ "code", "message" ], "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "details": { "type": "object", "nullable": true } } } }, "responses": { "OrderingUnauthorized": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponseV1" }, "example": { "data": null, "error": { "code": 401, "message": "An error occurred while attempting to decode the Jwt: Jwt expired at 2023-02-15T11:29:44Z", "details": null } } } } } }, "parameters": { "PageableSize": { "name": "size", "in": "query", "description": "The number of results on a result page.\n", "required": false, "style": "form", "explode": true, "schema": { "type": "integer", "example": 10, "default": 20 } }, "PageablePage": { "name": "page", "in": "query", "description": "The result page number. To get the first page, set the parameter to `0`.\n", "required": false, "style": "form", "explode": true, "schema": { "type": "integer", "example": 1, "default": 0 } }, "WorkspaceIdQuery": { "name": "workspaceId", "in": "query", "description": "The workspace ID.\n\nUse to get objects from a specific workspace. Otherwise, objects from the entire account will be returned.\n", "required": false, "style": "form", "explode": true, "schema": { "type": "string", "format": "uuid", "example": "68567134-27ad-7bd7-4b65-d61adb11fc78" } }, "OrderIdQuery": { "name": "orderId", "in": "query", "description": "The order ID.\n", "required": false, "style": "form", "explode": true, "schema": { "type": "string", "format": "uuid", "example": "68567134-27ad-7bd7-4b65-d61adb11fc78" } }, "PageableSorting": { "name": "sort", "in": "query", "description": "The results sorting method that arranges elements in ascending or descending order based on a chosen field. The format is `,`.\n", "required": false, "style": "form", "explode": true, "schema": { "type": "string", "example": "id,asc", "default": "createdAt,desc" } } }, "securitySchemes": { "httpBearer": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" } } } } ```