> ## Documentation Index > Fetch the complete documentation index at: https://docs-platform.crewai.com/llms.txt > Use this file to discover all available pages before exploring further. # Get an execution of an Automation > Returns one kickoff execution of the Automation with its inputs, output and error. Training runs, test runs, chat turns and crew runs nested inside a flow are not kickoffs and return 404. ## OpenAPI ````yaml /openapi/platform-v1.yaml get /api/v1/automations/{automation_id}/executions/{execution_id} openapi: 3.0.1 info: title: CrewAI Platform API version: v1 description: Supported public API for CrewAI Platform. servers: - url: https://app.crewai.com description: Current CrewAI Platform host security: - bearerAuth: [] tags: - name: Users description: Users in the organization. - name: Status description: Platform health and API availability. - name: Automations description: Automations, their source artifacts, and their executions. - name: Teams description: Teams in the organization. - name: Group Mappings description: Identity-provider group mappings to Teams. - name: Service Accounts description: Service accounts in the organization. - name: Webhook Endpoints description: Endpoints that receive signed event deliveries. - name: Studio Projects description: Projects built in Crew Studio. paths: /api/v1/automations/{automation_id}/executions/{execution_id}: parameters: - name: automation_id in: path required: true schema: type: string format: uuid example: 4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a - name: execution_id in: path required: true schema: type: string format: uuid example: 4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a get: tags: - Automations summary: Get an execution of an Automation description: > Returns one kickoff execution of the Automation with its inputs, output and error. Training runs, test runs, chat turns and crew runs nested inside a flow are not kickoffs and return 404. operationId: getAutomationExecution responses: '200': description: OK content: application/json: examples: success: value: data: id: 4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a status: completed source: schedule executed_by: type: User id: f9630a31-1640-4f02-865b-3f92e4d99335 started_at: '2026-07-07T00:00:01Z' finished_at: '2026-07-07T00:01:30Z' inputs: topic: lead qualification output: '{"summary": "Three new leads qualified."}' output_format: json error: null created_at: '2026-07-07T00:00:00Z' updated_at: '2026-07-07T00:00:00Z' summary: A completed execution schema: type: object required: - data additionalProperties: false properties: data: type: object required: - id - status - source - executed_by - started_at - finished_at - inputs - output - output_format - error - created_at - updated_at additionalProperties: false properties: id: type: string format: uuid example: 4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a status: type: string enum: - queued - running - cancelling - waiting_for_input - completed - failed - timed_out - cancelled - unknown example: completed description: > Execution lifecycle status: - `queued`: The execution was accepted and has not started. - `running`: The execution is running. - `cancelling`: A cancellation was requested and the execution is stopping. - `waiting_for_input`: The execution is paused until a person answers a human-input request. - `completed`: The execution finished successfully. - `failed`: The execution finished with an error. - `timed_out`: The execution ran past its time limit. - `cancelled`: The execution was cancelled. - `unknown`: The platform could not determine the status. source: type: string enum: - api - ui - schedule - trigger - unknown example: schedule description: > How the execution was started: - `api`: A kickoff request to the platform API or to the Automation's own URL. - `ui`: A kickoff from the CrewAI web app. - `schedule`: A scheduled kickoff. - `trigger`: An event from a connected integration. - `unknown`: The execution was started some other way. executed_by: type: object required: - type - id additionalProperties: false properties: type: type: string example: User enum: - User x-crewai-enum-format: freeform id: type: string format: uuid example: 4f6d0d9a-7b78-4c6a-b64f-2e2e3d2c8f9a nullable: true description: >- The identity the execution ran as. Null when the runtime did not report one. started_at: type: string format: date-time example: '2026-07-07T00:00:00Z' nullable: true finished_at: type: string format: date-time example: '2026-07-07T00:00:00Z' nullable: true inputs: type: object additionalProperties: true description: The inputs the execution was kicked off with. output: type: string example: '{"summary": "Three new leads qualified."}' nullable: true description: >- The final output the Automation returned. Null until the execution finishes, or when it returned nothing. output_format: type: string enum: - json - text nullable: true example: json description: > How to read `output`. Null when `output` is null: - `json`: `output` is a JSON object or array, ready to parse. A surrounding Markdown code fence is removed. - `text`: `output` is text exactly as the Automation returned it. error: type: object nullable: true required: - type - message additionalProperties: false description: >- Why the execution failed. Null unless it failed. For a crew, this is the first failed task's error when the run recorded none of its own. properties: type: type: string example: ValueError nullable: true description: >- The exception type the runtime reported, when it reported one. message: type: string example: 'ValueError: topic must be a string' created_at: type: string format: date-time example: '2026-07-07T00:00:00Z' updated_at: type: string format: date-time example: '2026-07-07T00:00:00Z' '401': description: Unauthorized content: application/json: examples: unauthorized: value: errors: - type: >- https://docs-platform.crewai.com/api/problems/unauthorized code: unauthorized title: Unauthorized status: 401 detail: Missing or invalid bearer token. summary: Missing or invalid bearer token schema: $ref: '#/components/schemas/ErrorEnvelope' '404': description: Not Found content: application/json: examples: not_found: value: errors: - type: >- https://docs-platform.crewai.com/api/problems/not_found code: not_found title: Not found status: 404 detail: The requested resource could not be found. summary: Execution is not a kickoff of this Automation schema: $ref: '#/components/schemas/ErrorEnvelope' components: schemas: ErrorEnvelope: type: object required: - errors additionalProperties: false properties: errors: type: array minItems: 1 items: $ref: '#/components/schemas/Error' Error: type: object description: Public API error object. required: - type - code - title - status - detail additionalProperties: false properties: type: type: string format: uri enum: - https://docs-platform.crewai.com/api/problems/bad_request - https://docs-platform.crewai.com/api/problems/clipper_disabled - https://docs-platform.crewai.com/api/problems/clipper_disallowed - >- https://docs-platform.crewai.com/api/problems/clipper_feature_disabled - https://docs-platform.crewai.com/api/problems/clipper_not_found - https://docs-platform.crewai.com/api/problems/conflict - https://docs-platform.crewai.com/api/problems/forbidden - https://docs-platform.crewai.com/api/problems/internal_error - https://docs-platform.crewai.com/api/problems/not_found - https://docs-platform.crewai.com/api/problems/service_unavailable - >- https://docs-platform.crewai.com/api/problems/tool_execution_failed - https://docs-platform.crewai.com/api/problems/unauthorized - https://docs-platform.crewai.com/api/problems/validation_error example: https://docs-platform.crewai.com/api/problems/bad_request code: type: string enum: - bad_request - clipper_disabled - clipper_disallowed - clipper_feature_disabled - clipper_not_found - conflict - forbidden - internal_error - not_found - service_unavailable - tool_execution_failed - unauthorized - validation_error example: bad_request title: type: string x-crewai-enum-format: freeform enum: - Bad request - Clipper resource disabled - Clipper resource disallowed - Clipper feature disabled - Clipper resource not found - Conflict - Forbidden - Internal error - Not found - Service unavailable - Tool execution failed - Unauthorized - Validation error example: Bad request status: type: integer enum: - 400 - 401 - 403 - 404 - 409 - 422 - 500 - 503 example: 400 detail: type: string example: The request is invalid. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: opaque ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.