> ## Documentation Index
> Fetch the complete documentation index at: https://leadping.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a lead automation workflow status

> Returns automation workflow status for one lead, including active runs, paused state, and follow-up progress for the current business.



## OpenAPI

````yaml /openapi.json get /leads/{id}/workflow-status
openapi: 3.0.4
info:
  title: Leadping API
  description: >-
    Leadping API for lead intake, messaging, calling, automations, billing,
    business settings, and compliant lead communication workflows.
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  version: v1
servers:
  - url: https://api.leadping.ai
    description: Production
security: []
tags:
  - name: Analytics
  - name: Automations
  - name: Contact
  - name: Conversations
  - name: Dispositions
  - name: Feedback
  - name: Leads
  - name: LeadStatuses
  - name: Notifications
  - name: OutboundDelivery
  - name: Sources
  - name: Suppressions
  - name: Tags
  - name: Users
  - name: Calls
  - name: PhoneNumbers
  - name: Sms
  - name: Telephony
  - name: UserDataExports
  - name: CallEvents
  - name: Events
  - name: SmsEvents
  - name: Businesses
  - name: PaymentMethods
  - name: Transactions
  - name: Usage
  - name: Wallets
paths:
  /leads/{id}/workflow-status:
    get:
      tags:
        - Leads
      summary: Get a lead automation workflow status
      description: >-
        Returns automation workflow status for one lead, including active runs,
        paused state, and follow-up progress for the current business.
      operationId: Leads_GetWorkflowStatusForCurrentUser
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/AutomationWorkflowStatusResponse'
                description: Automation workflow status collection for a lead.
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
components:
  schemas:
    AutomationWorkflowStatusResponse:
      type: object
      properties:
        leadId:
          type: string
          description: >-
            Unique identifier of the lead associated with this Leadping
            automation workflow status.
        runs:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/AutomationWorkflowRunResponse'
            description: User-safe automation workflow run status returned for a lead.
          description: >-
            Collection of runs included with this Leadping automation workflow
            status.
      description: Automation workflow status collection for a lead.
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          description: URI reference that identifies the problem type.
          nullable: true
        title:
          type: string
          description: Short, human-readable summary of the problem.
          nullable: true
        status:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: HTTP status code returned for the problem.
          format: int32
          nullable: true
        detail:
          type: string
          description: >-
            Human-readable explanation specific to this occurrence of the
            problem.
          nullable: true
        instance:
          type: string
          description: >-
            URI reference that identifies this specific occurrence of the
            problem.
          nullable: true
    AutomationWorkflowRunResponse:
      type: object
      properties:
        id:
          type: string
          description: Unique Leadping identifier for the automation workflow run.
        businessId:
          type: string
          description: >-
            Unique identifier of the business associated with this Leadping
            automation workflow run.
          nullable: true
        leadId:
          type: string
          description: >-
            Unique identifier of the lead associated with this Leadping
            automation workflow run.
          nullable: true
        automation:
          type: object
          allOf:
            - $ref: '#/components/schemas/IdNamePair'
          description: The ID and name for this automation.
          nullable: true
        triggerType:
          type: string
          description: >-
            Trigger type classification for this Leadping automation workflow
            run.
          nullable: true
        triggerDisplay:
          type: string
          description: >-
            Human-readable trigger display for this Leadping automation workflow
            run.
          nullable: true
        status:
          type: string
          description: Current status for this Leadping automation workflow run.
        statusDisplay:
          type: string
          description: >-
            Human-readable status display for this Leadping automation workflow
            run.
        currentStep:
          type: object
          allOf:
            - $ref: '#/components/schemas/IdNamePair'
          description: The ID and name for this currentStep.
          nullable: true
        currentStepOrder:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: >-
            Current step order associated with this Leadping automation workflow
            run.
          format: int32
          nullable: true
        nextExecutionAt:
          type: string
          description: Date and time when the next execution is scheduled.
          format: date-time
          nullable: true
        lastExecutionAt:
          type: string
          description: >-
            Date and time of the most recent execution for this Leadping
            automation workflow run.
          format: date-time
          nullable: true
        startedAt:
          type: string
          description: Date and time when the automation workflow run started.
          format: date-time
        updatedAt:
          type: string
          description: Date and time when the automation workflow run was last updated.
          format: date-time
        completedAt:
          type: string
          description: Date and time when the automation workflow run completed.
          format: date-time
          nullable: true
        failedAt:
          type: string
          description: Date and time when the automation workflow run failed.
          format: date-time
          nullable: true
        cancelledAt:
          type: string
          description: Date and time when the automation workflow run was cancelled.
          format: date-time
          nullable: true
        retryCount:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: >-
            Total number of retry records represented by this Leadping
            automation workflow run.
          format: int32
        maxRetryCount:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: >-
            Total number of max retry records represented by this Leadping
            automation workflow run.
          format: int32
        nextRetryAt:
          type: string
          description: Date and time when the next retry is scheduled.
          format: date-time
          nullable: true
        lastErrorCode:
          type: string
          description: >-
            Reason or diagnostic code that explains the current outcome for this
            Leadping automation workflow run.
          nullable: true
        lastErrorMessage:
          type: string
          description: >-
            Human-readable last error message for this Leadping automation
            workflow run.
          nullable: true
        skipReasonCode:
          type: string
          description: >-
            Reason or diagnostic code that explains the current outcome for this
            Leadping automation workflow run.
          nullable: true
        skipReasonDisplay:
          type: string
          description: >-
            Human-readable skip reason display for this Leadping automation
            workflow run.
          nullable: true
        lastActionSummary:
          type: string
          description: >-
            Human-readable last action summary for this Leadping automation
            workflow run.
          nullable: true
        actions:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/AutomationWorkflowActionResponse'
            description: >-
              User-safe action status returned for lead automation workflow
              visibility.
          description: >-
            Collection of actions included with this Leadping automation
            workflow run.
        events:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/AutomationWorkflowEventResponse'
            description: >-
              User-safe workflow history event returned for lead automation
              status.
          description: >-
            Collection of events included with this Leadping automation workflow
            run.
      description: User-safe automation workflow run status returned for a lead.
    IdNamePair:
      required:
        - id
        - name
      type: object
      properties:
        id:
          type: string
          description: The unique identifier.
        name:
          type: string
          description: The display name.
      description: >-
        A minimal Record type with an (string), (string), and maximum JSON
        compatibility. The reason for this type (over something like
        KeyValuePair, dictionary) is because of JSON serialization support.
    AutomationWorkflowActionResponse:
      type: object
      properties:
        id:
          type: string
          description: Unique Leadping identifier for the automation workflow action.
        stepId:
          type: string
          description: >-
            Unique identifier of the step associated with this Leadping
            automation workflow action.
          nullable: true
        stepOrder:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: Step order associated with this Leadping automation workflow action.
          format: int32
        stepDisplayName:
          type: string
          description: >-
            Human-readable step display name associated with this Leadping
            automation workflow action.
        actionType:
          type: string
          description: >-
            Action type classification for this Leadping automation workflow
            action.
        actionTypeDisplay:
          type: string
          description: >-
            Human-readable action type display for this Leadping automation
            workflow action.
        status:
          type: string
          description: Current status for this Leadping automation workflow action.
        statusDisplay:
          type: string
          description: >-
            Human-readable status display for this Leadping automation workflow
            action.
        scheduledAt:
          type: string
          description: Date and time when the automation workflow action was scheduled.
          format: date-time
          nullable: true
        startedAt:
          type: string
          description: Date and time when the automation workflow action started.
          format: date-time
          nullable: true
        completedAt:
          type: string
          description: Date and time when the automation workflow action completed.
          format: date-time
          nullable: true
        failedAt:
          type: string
          description: Date and time when the automation workflow action failed.
          format: date-time
          nullable: true
        skippedAt:
          type: string
          description: Date and time when the workflow action was skipped.
          format: date-time
          nullable: true
        retryCount:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: >-
            Total number of retry records represented by this Leadping
            automation workflow action.
          format: int32
        nextRetryAt:
          type: string
          description: Date and time when the next retry is scheduled.
          format: date-time
          nullable: true
        userSummary:
          type: string
          description: >-
            Human-readable user summary for this Leadping automation workflow
            action.
          nullable: true
        safeReason:
          type: string
          description: >-
            Safe reason associated with this Leadping automation workflow
            action.
          nullable: true
        failureCode:
          type: string
          description: >-
            Reason or diagnostic code that explains the current outcome for this
            Leadping automation workflow action.
          nullable: true
      description: >-
        User-safe action status returned for lead automation workflow
        visibility.
    AutomationWorkflowEventResponse:
      type: object
      properties:
        id:
          type: string
          description: Unique Leadping identifier for the automation workflow event.
        stepId:
          type: string
          description: >-
            Unique identifier of the step associated with this Leadping
            automation workflow event.
          nullable: true
        actionId:
          type: string
          description: >-
            Unique identifier of the action associated with this Leadping
            automation workflow event.
          nullable: true
        eventType:
          type: string
          description: >-
            Event type classification for this Leadping automation workflow
            event.
        status:
          type: string
          description: Current status for this Leadping automation workflow event.
        statusDisplay:
          type: string
          description: >-
            Human-readable status display for this Leadping automation workflow
            event.
        summary:
          type: string
          description: Human-readable summary for this Leadping automation workflow event.
        reasonCode:
          type: string
          description: >-
            Reason or diagnostic code that explains the current outcome for this
            Leadping automation workflow event.
          nullable: true
        occurredAt:
          type: string
          description: Date and time when the automation workflow event event occurred.
          format: date-time
      description: User-safe workflow history event returned for lead automation status.

````