Fenergo Nebula External Data Query — OpenAPI 3.0.4 contract published by Fenergo for the externaldataquery service of the Fen-X SaaS platform, carrying 24 path(s) and 24 operation(s). Harvested verbatim from Fenergo's own published specification endpoint.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/externaldataquery-v1-0"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
{
"openapi": "3.0.4",
"info": {
"title": "Fenergo Nebula External Data Query",
"description": "**External Data Query API**:\n\n<br> External Data Query API allows to retrieve information of external data providers and their configuration.\n\n<br> **External Data Query API provides**:<br><ul><li> The ability to get provider configuration.<li> The ability to get signed url for documents.<li> The ability to get imported data.<li> The ability to get mapping configuration of the provider.<li> The ability to get subscriptions for ongoing monitoring.<li> The ability to get external data search results.",
"version": "1.0"
},
"servers": [
{
"url": "/externaldataquery"
}
],
"paths": {
"/api/aggregation/{taskId}": {
"get": {
"tags": [
"Aggregation"
],
"summary": "Get aggregated company data by import request id",
"description": "\nThis method will return aggregated company data for given import request id<br /><br /><b>Required permissions:</b><br />Following permissions are required: ExternalDataAccess<br /><br /><b>Required permissions:</b><br />Following permissions are required: ExternalDataAccess",
"operationId": "GetAggregatedDataByTaskId",
"parameters": [
{
"name": "taskId",
"in": "path",
"description": "The ID of journey task",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"responses": {
"200": {
"description": "Instance of Fenergo.Nebula.ExternalData.Query.Application.Dto.DataAggregationResultDto class containing company data of aggregated entity",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DataAggregationResultDtoServiceResponse"
}
}
}
},
"400": {
"description": "Invalid request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"404": {
"description": "Resource not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Import request with given ID does not exist",
"type": "Error",
"errorCode": "Error Code"
}
]
}
}
}
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"500": {
"description": "Internal server exception. Please, contact your provider.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "Internal server exception. Please, contact your provider.",
"type": "Error",
"errorCode": "INTERNAL_SERVER_ERROR"
}
]
}
}
}
},
"410": {
"description": "Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StringServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "This endpoint is obsolete and was terminated on yyyy-MM-dd",
"type": "Error",
"errorCode": "OBSOLETE_ENDPOINT"
}
]
}
}
}
}
}
}
},
"/api/providersconfiguration": {
"get": {
"tags": [
"Providers Configuration"
],
"summary": "Get External Data Providers Configuration",
"description": "\nGet base configuration details of external data providers.\n It returns configuration for global providers and custom providers.<br /><br /><b>Required permissions:</b><br />At least one of the following permissions is required: ExternalDataConfiguratorAccess, ExternalDataAccess<br /><br /><b>Required permissions:</b><br />At least one of the following permissions is required: ExternalDataConfiguratorAccess, ExternalDataAccess",
"operationId": "GetConfigurationV2",
"parameters": [
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"responses": {
"200": {
"description": "Instance of Fenergo.Nebula.ExternalData.Query.Application.Dto.Configuration.v2.ConfigurationDtoV2 class containing configuration information.",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/ConfigurationDtoV2ServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/ConfigurationDtoV2ServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/ConfigurationDtoV2ServiceResponse"
}
}
}
},
"400": {
"description": "Invalid request.",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"500": {
"description": "Internal server exception. Please, contact your provider.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "Internal server exception. Please, contact your provider.",
"type": "Error",
"errorCode": "INTERNAL_SERVER_ERROR"
}
]
}
}
}
},
"410": {
"description": "Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StringServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "This endpoint is obsolete and was terminated on yyyy-MM-dd",
"type": "Error",
"errorCode": "OBSOLETE_ENDPOINT"
}
]
}
}
}
}
}
}
},
"/api/providersconfiguration/provider/{providerId}": {
"get": {
"tags": [
"Providers Configuration"
],
"summary": "Get External Data provider configuration",
"description": "\nThis method returns specific External Data provider details.<br /><br /><b>Required permissions:</b><br />At least one of the following permissions is required: ExternalDataConfiguratorAccess, ExternalDataAccess<br /><br /><b>Required permissions:</b><br />At least one of the following permissions is required: ExternalDataConfiguratorAccess, ExternalDataAccess",
"operationId": "GetProviderConfigurationV2",
"parameters": [
{
"name": "providerId",
"in": "path",
"description": "The ID of provider",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"responses": {
"200": {
"description": "Instance of Fenergo.Nebula.ExternalData.Query.Application.Dto.Configuration.v2.ProviderConfigurationDtoV2 class containing provider configuration information.",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/ProviderConfigurationDtoV2ServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProviderConfigurationDtoV2ServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/ProviderConfigurationDtoV2ServiceResponse"
}
}
}
},
"400": {
"description": "Invalid request.",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"404": {
"description": "Resource not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "There is no provider with given id",
"type": "Error",
"errorCode": "Error Code"
}
]
}
}
}
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"500": {
"description": "Internal server exception. Please, contact your provider.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "Internal server exception. Please, contact your provider.",
"type": "Error",
"errorCode": "INTERNAL_SERVER_ERROR"
}
]
}
}
}
},
"410": {
"description": "Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StringServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "This endpoint is obsolete and was terminated on yyyy-MM-dd",
"type": "Error",
"errorCode": "OBSOLETE_ENDPOINT"
}
]
}
}
}
}
}
}
},
"/api/providersconfiguration/customProvider/{providerId}": {
"get": {
"tags": [
"Providers Configuration"
],
"summary": "Get custom provider configuration",
"description": "\nThis method returns specific custom External Data provider<br /><br /><b>Required permissions:</b><br />Following permissions are required: ExternalDataConfiguratorAccess<br /><br /><b>Required permissions:</b><br />Following permissions are required: ExternalDataConfiguratorAccess",
"operationId": "GetCustomProviderConfigurationV2",
"parameters": [
{
"name": "providerId",
"in": "path",
"description": "The ID of provider",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"responses": {
"200": {
"description": "Instance of Fenergo.Nebula.ExternalData.Query.Application.Dto.Configuration.v2.CustomProviderConfigurationDtoV2 class containing custom provider configuration information.",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/CustomProviderConfigurationDtoV2ServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustomProviderConfigurationDtoV2ServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/CustomProviderConfigurationDtoV2ServiceResponse"
}
}
}
},
"400": {
"description": "Invalid request.",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"404": {
"description": "Resource not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "There is no provider with given id",
"type": "Error",
"errorCode": "Error Code"
}
]
}
}
}
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"500": {
"description": "Internal server exception. Please, contact your provider.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "Internal server exception. Please, contact your provider.",
"type": "Error",
"errorCode": "INTERNAL_SERVER_ERROR"
}
]
}
}
}
},
"410": {
"description": "Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StringServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "This endpoint is obsolete and was terminated on yyyy-MM-dd",
"type": "Error",
"errorCode": "OBSOLETE_ENDPOINT"
}
]
}
}
}
}
}
}
},
"/api/providersconfiguration/flowProvider/{providerId}": {
"get": {
"tags": [
"Providers Configuration"
],
"summary": "Get flow provider configuration",
"description": "\nThis method returns specific flow External Data provider<br /><br /><b>Required permissions:</b><br />Following permissions are required: ExternalDataConfiguratorAccess<br /><br /><b>Required permissions:</b><br />Following permissions are required: ExternalDataConfiguratorAccess",
"operationId": "GetFlowProvider",
"parameters": [
{
"name": "providerId",
"in": "path",
"description": "The ID of provider",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"responses": {
"200": {
"description": "Instance of Fenergo.Nebula.ExternalData.Query.Application.FlowProviderConfigurationDto class containing custom provider configuration information.",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/FlowProviderConfigurationDtoServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/FlowProviderConfigurationDtoServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/FlowProviderConfigurationDtoServiceResponse"
}
}
}
},
"400": {
"description": "Invalid request.",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"404": {
"description": "Resource not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "There is no provider with given id",
"type": "Error",
"errorCode": "Error Code"
}
]
}
}
}
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"500": {
"description": "Internal server exception. Please, contact your provider.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "Internal server exception. Please, contact your provider.",
"type": "Error",
"errorCode": "INTERNAL_SERVER_ERROR"
}
]
}
}
}
},
"410": {
"description": "Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StringServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "This endpoint is obsolete and was terminated on yyyy-MM-dd",
"type": "Error",
"errorCode": "OBSOLETE_ENDPOINT"
}
]
}
}
}
}
}
}
},
"/api/providersconfiguration/adapterschema/{providerId}": {
"get": {
"tags": [
"Providers Configuration"
],
"summary": "Get Adapter Schema for provider",
"description": "\nThis method returns Adapter Schema for given External Data provider<br /><br /><b>Required permissions:</b><br />Following permissions are required: ExternalDataConfiguratorAccess<br /><br /><b>Required permissions:</b><br />Following permissions are required: ExternalDataConfiguratorAccess",
"operationId": "GetAdapterSchema",
"parameters": [
{
"name": "providerId",
"in": "path",
"description": "The ID of provider",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "entityType",
"in": "query",
"description": "Entity type for schema",
"schema": {
"type": "string"
}
},
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"responses": {
"200": {
"description": "Instance of Fenergo.Nebula.ExternalData.Query.Application.Dto.Configuration.v2.AdapterSchemaDto class containing Adapter Schema for provider.",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/AdapterSchemaDtoServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/AdapterSchemaDtoServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/AdapterSchemaDtoServiceResponse"
}
}
}
},
"400": {
"description": "Invalid request.",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"404": {
"description": "Resource not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "There is no schema id defined for given provider",
"type": "Error",
"errorCode": "Error Code"
}
]
}
}
}
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
# --- truncated at 32 KB (248 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/fenergo/refs/heads/main/openapi/fenergo-externaldataquery-v1-0-openapi.json