Every API here is available over the APIs.io API and to AI agents over MCP.
{
"openapi": "3.0.1",
"info": {
"title": "Fenergo Nebula Reporting Query",
"description": "Reporting Query API is part of FenX eco-system to manage Reporting. All the operations require valid access token obtained from Identity service.",
"version": "1.0.0"
},
"servers": [
{
"url": "/reportingquery"
}
],
"paths": {
"/api/entity-report/entity-created-report": {
"post": {
"tags": [
"EntityReport"
],
"summary": "Get entities created report",
"description": "\n\r\n Returns the list of entities created within a specified date range.\n<b>Limit:</b> 10000 entities, for more, please use the /file API\r\n <br /><br /><b>Required permissions:</b><br />Following permissions are required: ReportingAccess",
"operationId": "GetEntityCreatedReport",
"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"
}
],
"requestBody": {
"description": "Start and end date",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DateRangeReportRequestServiceRequest"
}
}
}
},
"responses": {
"200": {
"description": "Success. Entity report for specified criteria is returned",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EntityCreatedDtoDateRangeReportResponseServiceResponse"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"500": {
"description": "Internal server error"
},
"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"
}
]
}
}
}
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
}
}
}
},
"/api/entity-report/entity-created-report/file": {
"post": {
"tags": [
"EntityReport"
],
"summary": "Get entities created file report",
"description": "\nReturns the link to the file, with a list of entities created within a specified date range<br /><br /><b>Required permissions:</b><br />Following permissions are required: ReportingAccess",
"operationId": "GetEntityCreatedFileReport",
"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"
}
],
"requestBody": {
"description": "Start and end date",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DateRangeReportFileRequestServiceRequest"
}
}
}
},
"responses": {
"200": {
"description": "Success. Entity report for specified criteria is returned",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DateRangeReportFileResponseServiceResponse"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"500": {
"description": "Internal server error"
},
"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"
}
]
}
}
}
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
}
}
}
},
"/api/entity-report/entity-updated-report": {
"post": {
"tags": [
"EntityReport"
],
"summary": "Get entities updated report",
"description": "\n\r\n Returns the list of entities updated within a specified date range.\n<b>Limit:</b> 10000 entities, for more, please use the /file API\r\n <br /><br /><b>Required permissions:</b><br />Following permissions are required: ReportingAccess",
"operationId": "GetEntityUpdatedReport",
"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"
}
],
"requestBody": {
"description": "Start and end date",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DateRangeReportRequestServiceRequest"
}
}
}
},
"responses": {
"200": {
"description": "Success. Entity report for specified criteria is returned",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EntityUpdatedDtoDateRangeReportResponseServiceResponse"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"500": {
"description": "Internal server error"
},
"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"
}
]
}
}
}
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
}
}
}
},
"/api/entity-report/entity-updated-report/file": {
"post": {
"tags": [
"EntityReport"
],
"summary": "Get entities updated file report",
"description": "\nReturns the link to the file, with a list of entities updated within a specified date range<br /><br /><b>Required permissions:</b><br />Following permissions are required: ReportingAccess",
"operationId": "GetEntityUpdatedFileReport",
"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"
}
],
"requestBody": {
"description": "Start and end date",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DateRangeReportFileRequestServiceRequest"
}
}
}
},
"responses": {
"200": {
"description": "Success. Entity report for specified criteria is returned",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DateRangeReportFileResponseServiceResponse"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"500": {
"description": "Internal server error"
},
"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"
}
]
}
}
}
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
}
}
}
},
"/api/journey-report/journey-started-report": {
"post": {
"tags": [
"JourneyReport"
],
"summary": "Get report for journey started property",
"description": "\n\r\n Returns the list of journeys started within a specified date range.\n<b>Limit:</b> 10000 journeys, for more, please use the /file API\r\n <br /><br /><b>Required permissions:</b><br />Following permissions are required: ReportingAccess",
"operationId": "GetJourneyStartedReport",
"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"
}
],
"requestBody": {
"description": "Start and end date",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DateRangeReportRequestServiceRequest"
}
}
}
},
"responses": {
"200": {
"description": "Success. Journey report for specified criteria is returned",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/JourneyStartedDtoDateRangeReportResponseServiceResponse"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"500": {
"description": "Internal server error"
},
"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"
}
]
}
}
}
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
}
}
}
},
"/api/journey-report/journey-started-report/file": {
"post": {
"tags": [
"JourneyReport"
],
"summary": "Get file report for journey started property",
"description": "\nReturns the link to the file, with a list of journeys started within a specified date range<br /><br /><b>Required permissions:</b><br />Following permissions are required: ReportingAccess",
"operationId": "GetJourneyStartedFileReport",
"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"
}
],
"requestBody": {
"description": "Start and end date",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DateRangeReportFileRequestServiceRequest"
}
}
}
},
"responses": {
"200": {
"description": "Success. Journey report for specified criteria is returned",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DateRangeReportFileResponseServiceResponse"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"500": {
"description": "Internal server error"
},
"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"
}
]
}
}
}
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
}
}
}
},
"/api/journey-report/journey-completed-report": {
"post": {
"tags": [
"JourneyReport"
],
"summary": "Get report for journey completed property",
"description": "\n\r\n Returns the list of journeys completed within a specified date range.\n<b>Limit:</b> 10000 journeys, for more, please use the /file API\r\n <br /><br /><b>Required permissions:</b><br />Following permissions are required: ReportingAccess",
"operationId": "GetJourneyCompletedReport",
"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"
}
],
"requestBody": {
"description": "Start and end date",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DateRangeReportRequestServiceRequest"
}
}
}
},
"responses": {
"200": {
"description": "Success. Journey report for specified criteria is returned",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/JourneyCompletedDtoDateRangeReportResponseServiceResponse"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"500": {
"description": "Internal server error"
},
"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"
}
]
}
}
}
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
}
}
}
},
"/api/journey-report/journey-completed-report/file": {
"post": {
"tags": [
"JourneyReport"
],
"summary": "Get file report for journey completed property",
"description": "\nReturns the link to the file, with a list of journeys completed within a specified date range<br /><br /><b>Required permissions:</b><br />Following permissions are required: ReportingAccess",
"operationId": "GetJourneyCompletedFileReport",
"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"
}
],
"requestBody": {
"description": "Start and end date",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DateRangeReportFileRequestServiceRequest"
}
}
}
},
"responses": {
"200": {
"description": "Success. Journey report for specified criteria is returned",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DateRangeReportFileResponseServiceResponse"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"500": {
"description": "Internal server error"
},
"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"
}
]
}
}
}
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
}
}
}
},
"/api/journey-report/journey-updated-report": {
"post": {
"tags": [
"JourneyReport"
],
"summary": "Get report for journey updated property",
"description": "\n\r\n Returns the list of journeys updated within a specified date range.\n<b>Limit:</b> 10000 journeys, for more, please use the /file API\r\n <br /><br /><b>Required permissions:</b><br />Following permissions are required: ReportingAccess",
"operationId": "GetJourneyUpdatedReport",
"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"
}
],
"requestBody": {
"description": "Start and end date",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DateRangeReportRequestServiceRequest"
}
}
}
},
"responses": {
"200": {
"description": "Success. Journey report for specified criteria is returned",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/JourneyUpdatedDtoDateRangeReportResponseServiceResponse"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"500": {
"description": "Internal server error"
},
"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"
}
]
}
}
}
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
}
}
}
},
"/api/journey-report/journey-updated-report/file": {
"post": {
"tags": [
"JourneyReport"
],
"summary": "Get file report for journey updated property",
"description": "\nReturns the link to the file, with a list of journeys updated within a specified date range<br /><br /><b>Required permissions:</b><br />Following permissions are required: ReportingAccess",
"operationId": "GetJourneyUpdatedFileReport",
"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"
}
],
"requestBody": {
"description": "Start and end date",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DateRangeReportFileRequestServiceRequest"
}
}
}
},
"responses": {
"200": {
"description": "Success. Journey report for specified criteria is returned",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DateRangeReportFileResponseServiceResponse"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"500": {
"description": "Internal server error"
},
"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"
}
]
}
}
}
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"DateRangeReportFileRequest": {
"type": "object",
"properties": {
"startDate": {
"type": "string",
"description": "Start Date",
"format": "date-time",
"nullable": true,
"example": "2021-01-01T14:48:00.000Z"
},
"endDate": {
"type": "string",
"description": "End Date",
"format": "date-time",
"nullable": true,
"example": "2021-01-01T14:48:00.000Z"
},
"fileFormat": {
"$ref": "#/components/schemas/FileFormat"
}
},
"additionalProperties": false,
"description": "Request representing file report"
},
"DateRangeReportFileRequestServiceRequest": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/DateRangeReportFileRequest"
}
},
"additionalProperties": false,
"description": "Service request data"
},
"DateRangeReportFileResponse": {
"type": "object",
"properties": {
"reportFileUrl": {
"type": "string",
"description": "Report File URL",
"nullable": true,
"example": "https://google.com/report.csv"
},
"count": {
"type": "integer",
"description": "Count",
"format": "int32",
"example": 23
},
"expirationDate": {
"type": "string",
"description": "Link expiration date",
"format": "date-time",
"example": "2021-01-01T14:48:00.000Z"
}
},
"additionalProperties": false,
"description": "Response representing file report"
},
"DateRangeReportFileResponseServiceResponse": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/DateRangeReportFileResponse"
},
"messages": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ServiceResponseMessage"
},
"description": "List of Fenergo.Nebula.Platform.Core.Models.Response.ServiceResponseMessage associated to the service response",
"nullable": true
}
},
"additionalProperties": false,
"description": "Service response data"
},
"DateRangeReportRequest": {
"type": "object",
"properties": {
"startDate": {
"type": "string",
"description": "Start Date",
"format": "date-time",
"nullable": true,
"example": "2021-01-01T14:48:00.000Z"
},
"endDate": {
"type": "string",
"description": "End Date",
"format": "date-time",
"nullable": true,
"example": "2021-01-01T14:48:00.000Z"
}
},
"additionalProperties": false,
"description": "Request representing report"
},
"DateRangeReportRequestServiceRequest": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/DateRangeReportRequest"
}
},
"additionalProperties": false,
"description": "Service request data"
},
"EntityCreatedDto": {
"type": "object",
"properties": {
# --- truncated at 32 KB (51 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/fenergo/refs/heads/main/openapi/fenergo-reportingquery-v1-0-0-openapi.json