--- title: Get logs and status from instance --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Workflows](https://developers.cloudflare.com/api/resources/workflows) [Instances](https://developers.cloudflare.com/api/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 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` ##### P ath ParametersExpand Collapse account\_id: string [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: string 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: string 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)>) ##### Q uery ParametersExpand Collapse
order: optional "asc"or "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 "true"or "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
errors: array of object {code, message } code: number Link to this property message: string Link to this property
[Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)
messages: array of object {code, message } code: number Link to this property message: string Link to this property
[Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)
result: object {end, error, output, 11 more } end: string formatdate-time Link to this property
error: object {message, name } message: string Link to this property name: string Link to this property
Link to this property
output: stringor number One of the following: string Link to this property number Link to this property
Link to this property params: unknown Link to this property queued: string formatdate-time Link to this property
rollback: object {error, outcome }
error: object {message, name } message: string Link to this property name: string Link to this property
Link to this property
outcome: "complete"or "failed" One of the following: "complete" Link to this property "failed" Link to this property
Link to this property
Link to this property start: string formatdate-time Link to this property
status: "queued"or "running"or "paused"or 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: number maximum9007199254740991 minimum-9007199254740991 Link to this property
steps: array of object {attempts, config, end, 5 more } or object {end, error, finished, 3 more } or object {trigger, type } or object {end, error, finished, 5 more } One of the following:
object {attempts, config, end, 5 more }
attempts: array of object {end, error, start, success } end: string formatdate-time Link to this property
error: object {message, name } message: string Link to this property name: string Link to this property
Link to this property start: string formatdate-time Link to this property success: boolean Link to this property
Link to this property
config: object {retries, timeout, sensitive }
retries: object {delay, limit, backoff }
delay: stringor number Specifies the delay duration. The value ‘\[dynamic]’ means that a user-supplied function computes the delay. One of the following: string Link to this property number Link to this property
Link to this property limit: number Link to this property
backoff: optional "constant"or "linear"or "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: stringor number Specifies the timeout duration. One of the following: string Link to this property number Link to this property
Link to this property sensitive: optional "output" When set to ‘output’, step output is redacted from log and step output responses. Link to this property
Link to this property end: string formatdate-time Link to this property name: string Link to this property output: string Link to this property start: string formatdate-time Link to this property success: boolean Link to this property
type: "step"or "rollback" One of the following: "step" Link to this property "rollback" Link to this property
Link to this property
Link to this property
object {end, error, finished, 3 more } end: string formatdate-time Link to this property
error: object {message, name } message: string Link to this property name: string Link to this property
Link to this property finished: boolean Link to this property name: string Link to this property start: string formatdate-time Link to this property type: "sleep" Link to this property
Link to this property
object {trigger, type }
trigger: object {source } source: string Link to this property
Link to this property type: "termination" Link to this property
Link to this property
object {end, error, finished, 5 more } end: string formatdate-time Link to this property
error: object {message, name } message: string Link to this property name: string Link to this property
Link to this property finished: boolean Link to this property name: string Link to this property start: string formatdate-time Link to this property type: "waitForEvent" Link to this property event\_type: optional string Link to this property output: optional string Link to this property
Link to this property
Link to this property success: boolean Link to this property
trigger: object {source }
source: "unknown"or "api"or "binding"or 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 versionId: string formatuuid Link to this property
schedule: optional object {cron, scheduledTime } cron: string Link to this property scheduledTime: number Link to this property
Link to this property
[Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20result>) success: true [Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
result\_info: optional object {count, per\_page, total\_count, 3 more } count: number Link to this property per\_page: number Link to this property total\_count: number Link to this property cursor: optional string Link to this property page: optional number Link to this property total\_pages: optional number Link to this property
[Link to this property](<#(resource)%20workflows.instances%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>) ### Get logs and status from instance HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/workflows/$WORKFLOW_NAME/instances/$INSTANCE_ID \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 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 } } ```