--- title: Get logs and status from instance --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Workflows](https://developers.cloudflare.com/api/python/resources/workflows) [Instances](https://developers.cloudflare.com/api/python/resources/workflows/subresources/instances) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get logs and status from instance workflows.instances.get(strinstance\_id, InstanceGetParams\*\*kwargs) -> [InstanceGetResponse]() GET/accounts/{account\_id}/workflows/{workflow\_name}/instances/{instance\_id} Retrieves logs and execution status for a specific workflow instance. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `Workers Tail Read``Workers Scripts Write``Workers Scripts Read` ##### ParametersExpand Collapse account\_id: str [Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) workflow\_name: str maxLength64 minLength1 [Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20workflow_name%20%3E%20(schema)>) instance\_id: str maxLength271 minLength1 [Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20instance_id%20%3E%20(schema)>)
order: Optional\[Literal\["asc", "desc"]] Step ordering: “asc” (default, oldest first) or “desc” (newest first). One of the following: "asc" Link to this property "desc" Link to this property
[Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20order%20%3E%20(schema)>)
simple: Optional\[Literal\["true", "false"]] When true, omits step details and returns only metadata with step\_count. One of the following: "true" Link to this property "false" Link to this property
[Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20simple%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class InstanceGetResponse: … end: Optional\[datetime] formatdate-time Link to this property
error: Optional\[Error] message: str Link to this property name: str Link to this property
Link to this property
output: Union\[str, float] One of the following: str Link to this property float Link to this property
Link to this property params: object Link to this property queued: datetime formatdate-time Link to this property
rollback: Optional\[Rollback]
error: Optional\[RollbackError] message: str Link to this property name: str Link to this property
Link to this property
outcome: Literal\["complete", "failed"] One of the following: "complete" Link to this property "failed" Link to this property
Link to this property
Link to this property start: Optional\[datetime] formatdate-time Link to this property
status: Literal\["queued", "running", "paused", 6 more] One of the following: "queued" Link to this property "running" Link to this property "paused" Link to this property "errored" Link to this property "terminated" Link to this property "complete" Link to this property "waitingForPause" Link to this property "waiting" Link to this property "rollingBack" Link to this property
Link to this property step\_count: int maximum9007199254740991 minimum-9007199254740991 Link to this property
steps: List\[Step] One of the following:
class StepUnionMember0: …
attempts: List\[StepUnionMember0Attempt] end: Optional\[datetime] formatdate-time Link to this property
error: Optional\[StepUnionMember0AttemptError] message: str Link to this property name: str Link to this property
Link to this property start: datetime formatdate-time Link to this property success: Optional\[bool] Link to this property
Link to this property
config: StepUnionMember0Config
retries: StepUnionMember0ConfigRetries
delay: Union\[str, float] Specifies the delay duration. The value ‘\[dynamic]’ means that a user-supplied function computes the delay. One of the following: str Link to this property float Link to this property
Link to this property limit: float Link to this property
backoff: Optional\[Literal\["constant", "linear", "exponential"]] One of the following: "constant" Link to this property "linear" Link to this property "exponential" Link to this property
Link to this property
Link to this property
timeout: Union\[str, float] Specifies the timeout duration. One of the following: str Link to this property float Link to this property
Link to this property sensitive: Optional\[Literal\["output"]] When set to ‘output’, step output is redacted from log and step output responses. Link to this property
Link to this property end: Optional\[datetime] formatdate-time Link to this property name: str Link to this property output: Optional\[str] Link to this property start: datetime formatdate-time Link to this property success: Optional\[bool] Link to this property
type: Literal\["step", "rollback"] One of the following: "step" Link to this property "rollback" Link to this property
Link to this property
Link to this property
class StepUnionMember1: … end: datetime formatdate-time Link to this property
error: Optional\[StepUnionMember1Error] message: str Link to this property name: str Link to this property
Link to this property finished: bool Link to this property name: str Link to this property start: datetime formatdate-time Link to this property type: Literal\["sleep"] Link to this property
Link to this property
class StepUnionMember2: …
trigger: StepUnionMember2Trigger source: str Link to this property
Link to this property type: Literal\["termination"] Link to this property
Link to this property
class StepUnionMember3: … end: datetime formatdate-time Link to this property
error: Optional\[StepUnionMember3Error] message: str Link to this property name: str Link to this property
Link to this property finished: bool Link to this property name: str Link to this property start: datetime formatdate-time Link to this property type: Literal\["waitForEvent"] Link to this property event\_type: Optional\[str] Link to this property output: Optional\[str] Link to this property
Link to this property
Link to this property success: Optional\[bool] Link to this property
trigger: Trigger
source: Literal\["unknown", "api", "binding", 2 more] One of the following: "unknown" Link to this property "api" Link to this property "binding" Link to this property "event" Link to this property "cron" Link to this property
Link to this property
Link to this property version\_id: str formatuuid Link to this property
schedule: Optional\[Schedule] cron: str Link to this property scheduled\_time: float Link to this property
Link to this property
[Link to this property](<#(resource)%20workflows.instances%20%3E%20(model)%20instance_get_response%20%3E%20(schema)>) ### Get logs and status from instance Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) instance = client.workflows.instances.get( instance_id="x", account_id="account_id", workflow_name="x", ) print(instance.end) ``` 200 example ``` { "errors": [], "messages": [ { "code": 0, "message": "message" } ], "result": { "end": "2019-12-27T18:11:19.117Z", "error": { "message": "message", "name": "name" }, "output": "string", "params": {}, "queued": "2019-12-27T18:11:19.117Z", "rollback": { "error": { "message": "message", "name": "name" }, "outcome": "complete" }, "start": "2019-12-27T18:11:19.117Z", "status": "queued", "step_count": -9007199254740991, "steps": [ { "attempts": [ { "end": "2019-12-27T18:11:19.117Z", "error": { "message": "message", "name": "name" }, "start": "2019-12-27T18:11:19.117Z", "success": true } ], "config": { "retries": { "delay": "string", "limit": 0, "backoff": "constant" }, "timeout": "string", "sensitive": "output" }, "end": "2019-12-27T18:11:19.117Z", "name": "name", "output": "output", "start": "2019-12-27T18:11:19.117Z", "success": true, "type": "step" } ], "success": true, "trigger": { "source": "unknown" }, "versionId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "schedule": { "cron": "cron", "scheduledTime": 0 } }, "success": true, "result_info": { "count": 0, "per_page": 0, "total_count": 0, "cursor": "cursor", "page": 0, "total_pages": 0 } } ``` ##### Returns Examples 200 example ``` { "errors": [], "messages": [ { "code": 0, "message": "message" } ], "result": { "end": "2019-12-27T18:11:19.117Z", "error": { "message": "message", "name": "name" }, "output": "string", "params": {}, "queued": "2019-12-27T18:11:19.117Z", "rollback": { "error": { "message": "message", "name": "name" }, "outcome": "complete" }, "start": "2019-12-27T18:11:19.117Z", "status": "queued", "step_count": -9007199254740991, "steps": [ { "attempts": [ { "end": "2019-12-27T18:11:19.117Z", "error": { "message": "message", "name": "name" }, "start": "2019-12-27T18:11:19.117Z", "success": true } ], "config": { "retries": { "delay": "string", "limit": 0, "backoff": "constant" }, "timeout": "string", "sensitive": "output" }, "end": "2019-12-27T18:11:19.117Z", "name": "name", "output": "output", "start": "2019-12-27T18:11:19.117Z", "success": true, "type": "step" } ], "success": true, "trigger": { "source": "unknown" }, "versionId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "schedule": { "cron": "cron", "scheduledTime": 0 } }, "success": true, "result_info": { "count": 0, "per_page": 0, "total_count": 0, "cursor": "cursor", "page": 0, "total_pages": 0 } } ```